Tạo dự án dành cho nhà phát triển

Các dự án của nhà phát triển, bao gồm cả chế độ tích hợp Matter, được quản lý trên Google Home Developer Console. Trang này giải thích cách thiết lập một dự án mới dành cho nhà phát triển trên Developer Console.

Các quy định hạn chế

Bạn không thể thêm chức năng Cloud-to-cloud hoặc Local Home SDK vào dự án trong Developer Console. Nếu muốn thêm chức năng Matter vào một tiện ích tích hợp Cloud-to-cloud hoặc Local Home hiện có, trước tiên, bạn phải nhập một dự án Actions on Google hiện có.

Đặt tên cho dự án

Khi đặt tên cho dự án, bạn nên đặt tên sao cho:

  • Kết hợp một số thông tin cơ bản về dự án.
  • Không dễ bị nhầm lẫn với dự án của một dự án khác.
  • Có thể đại diện cho tất cả integrationtrong dự án.

Tên có ý nghĩa rất quan trọng. Một tên chung như project-gamma-798 sẽ được "ngụy trang" một cách hiệu quả và sẽ không nổi bật trong danh sách các dự án có tên chung khác.

Hãy cân nhắc làm theo hướng dẫn sau đây khi đặt tên cho dự án:

  • Sử dụng tên công ty của bạn
  • Sử dụng loại dự án hoặc hành động trong tên
  • Đừng sử dụng từ "test" (kiểm thử) trong tên dự án

Ví dụ: acme-smarthomeacme-lighting là tên dự án rõ ràng và duy nhất.

Tạo dự án

Một dự án của nhà phát triển đại diện cho một hoặc nhiều integration. Bằng cách chia sẻ dự án với các thành viên trong nhóm phát triển của mình, chủ sở hữu có thể cho phép người dùng khác quản lý tất cả integrationtrong dự án.

Các Hệ sinh thái nhà thông minh của Google integrationđược quản lý bằng Developer Console mới. Có 2 phương thức thiết lập dự án trong Developer Console:

  1. Tạo dự án mới.
  2. Nhập một dự án hiện có từ bảng điều khiển Actions on Google.

Bạn chỉ nên tạo một dự án cho tất cả các mục tích hợp Matter, cả kiểm thử và phát hành chính thức, đặc biệt là để tránh các vấn đề khi kiểm thử bằng Mã nhà cung cấp kiểm thử và Mã sản phẩm cho Matter.

Phương thức 1: Tạo một dự án mới

Chuyển đến Developer Console:

Truy cập Developer Console

  1. Trên trang Quản lý dự án, nhấp vào Tạo dự án.
  2. Trên trang Get started (Bắt đầu), hãy nhấp vào Create project (Tạo dự án).
  3. Nhập tên dự án của bạn, tên này phải tuân thủ các nguyên tắc đặt tên dự án.
  4. Nhấp vào Create New Project (Tạo dự án mới).

Bạn sẽ được chuyển hướng về Trang chủ của dự án mới.

Phương pháp 2: Nhập dự án hiện có từ bảng điều khiển Actions on Google

Bạn có thể nhập một dự án Actions on Google hiện có vào Developer Console mới nếu cần thêm tính năng hỗ trợ Matter vào quy trình tích hợp Cloud-to-cloud hoặc Local Home hiện có.

Các hạn chế sau áp dụng cho phương thức này:

  • Việc nhập này chỉ có thể thực hiện một chiều. Bạn không thể huỷ thao tác này sau khi thực hiện.
  • Chỉ chủ sở hữu dự án mới có thể nhập dự án Actions on Google hiện có. Chủ sở hữu là người đã tạo dự án và có thể xem được dự án đó bằng đường liên kết Thành viên.
  • Bạn chỉ có thể chỉnh sửa Hồ sơ công ty của một dự án đã nhập trong Actions on Google Console. Những thay đổi ở đó sẽ được phản ánh trong Google Home Developer Console.

Sau khi nhập, bạn vẫn có thể sử dụng dự án Actions on Google gốc để quản lý các công cụ tích hợp hiện có (chẳng hạn như Cloud-to-cloud, Local Home, App Discovery).

Để nhập một dự án hiện có từ Actions on Google Console, hãy chuyển đến Developer Console:

Truy cập Developer Console

  1. Nhấp vào Create a Project (Tạo dự án).
  2. Nhập tên dự án Actions hiện có hoặc chọn một dự án trong danh sách thả xuống (ví dụ: trong ảnh chụp màn hình sau đây, tên dự án là "My Matter project").
  3. Nhấp vào Nhập dự án.

Bạn sẽ được chuyển hướng trở lại thông tin chi tiết về dự án hiện có trong Developer Console.

Bắt đầu sử dụng Trung tâm dành cho nhà phát triển Google Home

Đặt cấp độ nhật ký

Theo mặc định, chỉ nhật ký lỗi được lưu vào Google Cloud cho mỗi lần tích hợp trong dự án.

Để lưu tất cả nhật ký vào Google Cloud cho từng hoạt động tích hợp, hãy chọn Tất cả nhật ký trong phần Kiểm soát cấp độ nhật ký: Nhật ký lỗi.

Cấp độ nhật ký dự án trong Trung tâm dành cho nhà phát triển Google Home

Chế độ cài đặt này áp dụng cho tất cả chế độ tích hợp trong dự án của bạn. Không thể đặt giá trị này cho mỗi chế độ tích hợp. Việc lưu tất cả nhật ký vào Google Cloud có thể làm phát sinh thêm chi phí nếu bạn vượt quá dung lượng lưu trữ nhật ký.

Để tìm hiểu thêm về nhật ký, hãy xem bài viết Ghi nhật ký trên đám mây cho Matt.

Chia sẻ dự án của nhà phát triển

Bạn có thể thêm hoặc xoá quyền truy cập vào dự án giữa những người dùng trong nhóm của mình bằng cách sử dụng các vai trò được xác định trước.

  1. Trên Trang chủ của Developer Console, hãy nhấp vào Thành viên. Thao tác này sẽ đưa bạn đến trang IAM và Quản trị viên > IAM trên Google Cloud Console.

    Hoặc nhấp vào Chi tiết dự án, sau đó nhấp vào Quản lý thành viên trong GCP trong phần Thành viên ở dưới cùng.

  2. Thực hiện các thay đổi nếu cần bằng cách sử dụng trang tổng quan Google Cloud Console.

Để biết hướng dẫn về cách sửa đổi quyền truy cập vào một dự án, hãy tham khảo bài viết Kiểm soát quyền truy cập cho các dự án có IAM.

Sau khi được thêm vào danh sách người dùng, người dùng có thể xem dự án và mọi nội dung tích hợp trong Developer Console.

Theo chế độ cài đặt của tổ chức, bạn có thể gặp lỗi về quyền khi cố gắng tạo dự án dành cho nhà phát triển. Nếu vậy, hãy liên hệ với quản trị viên Google Cloud và yêu cầu quyền của Người tạo dự án cho tài khoản của bạn.