Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Tạo ứng dụng mẫu iOS

Ứng dụng mẫu dành cho iOS này sử dụng API Google Home. Hãy tham khảo hướng dẫn này để tạo và chạy ứng dụng lần đầu tiên.

Điều kiện tiên quyết

Đảm bảo bạn đáp ứng các yêu cầu tối thiểu để sử dụng API Home cho iOS.

Để tạo và cài đặt Ứng dụng mẫu, bạn cần có một máy tính đã cài đặt Xcode phiên bản 15.3 trở lên.

Tải Xcode xuống

Để kiểm thử ứng dụng, bạn cần:

Một Tài khoản Google.
Một ID Apple đã đăng ký trong Chương trình nhà phát triển của Apple để tạo tệp cấu hình thiết bị thực. Nếu chưa tạo, bạn sẽ phải trả thêm chi phí đăng ký và có thể mất đến 48 giờ để hoàn tất.
Một thiết bị iOS (không phải trình mô phỏng) chạy iOS 16.4 trở lên được thiết lập bằng tài khoản thử nghiệm.
Mạng Wi-Fi.
Một trung tâm Google hỗ trợ API Home.
Một bộ định tuyến biên theo giao thức Thread nếu thiết bị của bạn yêu cầu giao thức Thread và trung tâm của bạn không có tính năng đó.
Ít nhất một loại thiết bị được hỗ trợ.

Để phát triển, bạn cần có một máy Mac đáp ứng các yêu cầu sau:

macOS Sonoma trở lên
Xcode 15.3 trở lên

Tạo tệp cấu hình triển khai của Apple

Trước tiên, ứng dụng cần bật tính năng App Attest (Chứng thực ứng dụng). Do đó, bạn không thể triển khai ứng dụng này cho các thiết bị mô phỏng. Bạn cần tạo một hồ sơ cấp phép có quyền App Attest.

Thứ hai, ứng dụng này yêu cầu bật Nhóm ứng dụng để giao tiếp giữa ứng dụng và MatterExtension. Bạn cần đăng ký một giá trị nhận dạng nhóm ứng dụng.

Để biết thêm thông tin chi tiết, hãy xem bài viết Tạo hồ sơ cấp phép phát triển của Apple về hồ sơ cấp phép.

Sau đây là các bước tối thiểu cần thiết để triển khai một ứng dụng:

Tạo một giá trị nhận dạng nhóm ứng dụng để ứng dụng của bạn giao tiếp với MatterExtension.
1. Đăng nhập vào Cổng nhà phát triển của Apple.
2. Thêm một giá trị nhận dạng nhóm ứng dụng. Ví dụ: giá trị nhận dạng này có thể được định dạng là group.com.company.commissioning.
Đăng ký thiết bị thử nghiệm vào tài khoản nhà phát triển.
Tạo một hồ sơ cho mục tiêu ứng dụng của bạn.
1. Quyết định mã nhận dạng gói ứng dụng cho ứng dụng của bạn. Mã nhận dạng này phải là duy nhất và mang tính mô tả. Ví dụ: giá trị nhận dạng này có thể được định dạng là com.company.HomeApiSample. Giá trị nhận dạng này sẽ được sử dụng trong phần còn lại của phần này.
2. Đăng ký Mã ứng dụng. Khi được nhắc, hãy thêm tính năng App Attest và App Groups.
3. Chỉnh sửa Mã ứng dụng mới tạo và định cấu hình khả năng App Groups để thêm giá trị nhận dạng nhóm ứng dụng đã đăng ký.
4. Tạo một hồ sơ cấp phép phát triển cho quá trình phát triển ứng dụng. Liên kết hồ sơ này với Mã ứng dụng mới tạo và các thiết bị thử nghiệm đã chọn. Đảm bảo bạn có chứng chỉ nhà phát triển để ký ứng dụng.
  - Nếu bạn chưa tạo chứng chỉ, hãy xem bài viết Tạo chứng chỉ ID nhà phát triển để biết hướng dẫn.
Tạo một hồ sơ cho mục tiêu MatterExtension.
1. Quyết định mã nhận dạng gói ứng dụng cho MatterExtension. Giá trị nhận dạng này sẽ được kế thừa từ giá trị nhận dạng ứng dụng. Ví dụ: giá trị nhận dạng này có thể được định dạng là com.company.HomeApiSample.MatterExtension.
2. Đăng ký Mã ứng dụng. Khi được nhắc, hãy thêm tính năng App Group.
3. Chỉnh sửa Mã ứng dụng mới tạo và định cấu hình tính năng App Groups để thêm giá trị nhận dạng nhóm ứng dụng đã đăng ký được tạo ở các bước trước.
4. Tạo một hồ sơ cấp phép phát triển cho MatterExtension.

Tạo mã ứng dụng OAuth và bật API Home

Ứng dụng của bạn cần có mã ứng dụng OAuth để xác định ứng dụng đó với phần phụ trợ xác thực của Google. Đối với iOS và các ứng dụng, loại Ứng dụng OAuth mã ứng dụng khách phải được định cấu hình là iOS. Ứng dụng này cũng sẽ gọi đến API Home. Để bật chức năng này, bạn phải bật API trong dự án Google Cloud.

Tạo mã ứng dụng OAuth

Trong bảng điều khiển Cloud, hãy chuyển đến trang tổng quan bộ chọn dự án rồi chọn dự án mà bạn muốn dùng để tạo thông tin xác thực OAuth.
Chuyển đến trang API và dịch vụ bằng cách nhấp vào nút trình đơn ở phía trên cùng bên trái > Xem tất cả sản phẩm > API và dịch vụ.
Trong trình đơn điều hướng, hãy nhấp vào Thông tin xác thực.
Nếu bạn chưa định cấu hình màn hình xin phép cho dự án này trên Google Cloud, thì nút Configure consent screen (Định cấu hình màn hình xin phép) sẽ xuất hiện. Trong trường hợp đó, hãy định cấu hình màn hình xin phép theo quy trình sau. Nếu bạn đã định cấu hình màn hình xin phép bằng OAuth và trạng thái phát hành của màn hình đó là Testing (Thử nghiệm), hãy đảm bảo rằng các tài khoản thử nghiệm mà bạn sẽ sử dụng đã được thêm vào nhóm Test users (Người dùng thử nghiệm). Nếu không, hãy chuyển sang bước tiếp theo.
1. Tuỳ thuộc vào trường hợp sử dụng của bạn, hãy chọn Internal (Nội bộ) hoặc External (Bên ngoài), và rồi nhấp vào Create (Tạo). Ngăn OAuth consent screen (Màn hình xin phép bằng OAuth) sẽ xuất hiện.
2. Nhập thông tin trên App information page (Trang thông tin ứng dụng) theo hướng dẫn trên màn hình, rồi nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Scopes (Phạm vi) sẽ xuất hiện.
3. Bạn không cần thêm bất kỳ phạm vi nào, vì vậy hãy nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Test users (Người dùng thử nghiệm) sẽ xuất hiện.
4. Nếu chọn tạo màn hình xin phép nội bộ, bạn phải thêm người dùng để kiểm thử quyền truy cập vào ứng dụng của mình. Nhấp vào Add users (Thêm người dùng). Ngăn Add users (Thêm người dùng) sẽ xuất hiện. Người dùng thử nghiệm có đặc quyền cấp quyền trong ứng dụng của bạn. Trong trường trống, hãy thêm một hoặc nhiều địa chỉ email của Tài khoản Google, rồi nhấp vào Add (Thêm).
5. Nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Summary (Tóm tắt) sẽ xuất hiện.
6. Xem lại thông tin màn hình xin phép bằng OAuth, rồi nhấp vào Back to dashboard (Quay lại trang tổng quan).
Trên bảng điều khiển trình đơn bên trái, hãy nhấp vào Credentials (Thông tin xác thực) để tạo mã ứng dụng OAuth.
1. Nhấp vào nút CREATE CREDENTIALS (TẠO THÔNG TIN XÁC THỰC), rồi chọn OAuth client ID (Mã ứng dụng OAuth).
  1. Trong phần application type (loại ứng dụng), hãy chọn iOS.
2. Nhập Bundle ID (Mã nhận dạng gói) bằng giá trị nhận dạng ứng dụng và Apple Developer Team ID (Mã nhóm) của Nhà phát triển Apple. Bạn có thể để trống các trường khác.
3. Nhấp vào CREATE (TẠO) rồi ghi lại Client ID (Mã ứng dụng khách) đã tạo hoặc DOWNLOAD PLIST (TẢI PLIST XUỐNG). Mã này sẽ được dùng sau này để bật chức năng luồng quyền. Để biết thêm thông tin, hãy xem phần Tạo thông tin xác thực uỷ quyền section.

Bật API Home

Bật quyền truy cập vào API Home.

Trong thẻ APIs and Services (API và dịch vụ), hãy nhấp vào Enabled APIs &Services (API và dịch vụ đã bật).
Nhấp vào ENABLE APIS AND SERVICES (BẬT API VÀ DỊCH VỤ) ở đầu trang.
Tìm kiếm HOME API rồi chọn API đó.
Trên trang chi tiết Home API (API Home), hãy nhấp vào ENABLE (BẬT).

Tải mã nguồn xuống

Bạn có thể xem mã nguồn của Ứng dụng mẫu trên GitHub.

Chuyển đến vị trí bạn muốn lưu dự án, sau đó sao chép dự án đó:

git clone https://github.com/google-home/google-home-api-sample-app-ios.git

Để tải dự án trên Xcode, hãy nhấp vào File > Open rồi chọn GoogleHomeAPISampleIOS.xcodeproj ở gốc kho lưu trữ đã sao chép.

Thêm SDK vào dự án

Dự án Ứng dụng mẫu cần thêm một số thông tin để tạo bản dựng. Trong đó có cả việc thêm tệp Khung SDK cục bộ, điền thông tin giá trị nhận dạng tài khoản nhà phát triển và điền mã ứng dụng OAuth.