Projekty deweloperów, które obejmują integracje Matter, są zarządzane w Google Home Developer Console. Na tej stronie dowiesz się, jak skonfigurować nowy projekt dla deweloperów w usłudze Developer Console.
Ograniczenia
Nazwij projekt
Nadawanie nazw projektom – warto, aby nazwa:
- Zawiera podstawowe informacje o projekcie.
- nie będzie łatwo pomylić z innym projektem;
- może reprezentować wszystkie integrationw projekcie;
Znaczące nazwy są ważne. Ogólna nazwa, np. project-gamma-798, jest skutecznie „zamaskowana” i nie wyróżnia się na liście innych projektów o ogólnych nazwach.
Podczas nadawania nazwy projektowi weź pod uwagę te wskazówki:
- Użyj nazwy firmy.
- Użyj w nazwie rodzaju projektu lub działania.
- Nie używaj słowa „test” w nazwie projektu.
Na przykład acme-smarthome i acme-lighting to czytelne i niepowtarzalne nazwy projektów.
Tworzenie projektu
Projekt dewelopera reprezentuje co najmniej 1 integrację. Udostępniając projekt członkom zespołu programistycznego, właściciel może zezwolić innym użytkownikom na zarządzanie wszystkimi integracjami w projekcie.
Integracjami z ekosystemem Google Smart Home można zarządzać za pomocą Developer Console.
Zalecamy utworzenie tylko 1 projektu dla wszystkich integracji Matter, zarówno testowych, jak i produkcyjnych, aby uniknąć problemów podczas testowania za pomocą testowych identyfikatorów dostawcy i produktu dla Matter.
Metoda 1. Utwórz nowy projekt
Otwórz stronę Developer Console:
- Na stronie Zarządzanie projektami kliknij Utwórz projekt.
- Na stronie Rozpoczęcie kliknij Utwórz projekt.
- Wpisz nazwę projektu, która powinna być zgodna z wytycznymi dotyczącymi nazewnictwa projektów.
- Kliknij Utwórz nowy projekt.
Nastąpi przekierowanie na stronę Główna nowego projektu.
Metoda 2. Importowanie istniejącego projektu z konsoli Actions on Google
Jeśli chcesz dodać obsługę Matter do istniejącej integracji Cloud-to-cloud lub Local Home SDK, możesz zaimportować do niej istniejący projekt Actions on Google.Developer Console
W przypadku tej metody obowiązują te ograniczenia:
- Importowanie jest możliwe tylko w jednym kierunku. Nie można go cofnąć.
- Tylko właściciel projektu może zaimportować istniejący projekt Actions on Google. Właścicielem jest osoba, która utworzyła projekt. Można go wyświetlić, korzystając z linku do członków.
- Profil firmy w zaimportowanym projekcie można edytować tylko w Konsoli Actions on Google. Zmiany te będą odzwierciedlane w Konsoli deweloperów Google Home.
Po imporcie oryginalnego projektu Actions on Google nadal można zarządzać dotychczasowymi integracjami (np. Cloud-to-cloud, Local Home, App Discovery).
Aby zaimportować istniejący projekt z Actions on Google Console, otwórz Developer Console:
- Kliknij Utwórz projekt.
- Wpisz nazwę istniejącego projektu Actions lub wybierz projekt z menu (np. na poniższym zrzucie ekranu nazwa projektu to „My matter project”).
- Kliknij Importuj projekt.
Zostaniesz przekierowany z powrotem do szczegółów istniejącego projektu w sekcji Developer Console.
Ustawianie poziomów logowania
Domyślnie w przypadku każdej integracji w projekcie Google Cloud są zapisywane tylko logi błędów.
Aby zapisywać wszystkie logi w folderze Google Cloud dla każdej integracji, w sekcji Kontrola poziomu logowania: Logs of error wybierz Wszystkie logi.
To ustawienie dotyczy wszystkich integracji w Twoim projekcie. Można go zastąpić tylko w przypadku integracji Cloud-to-cloud. Zapisywanie wszystkich dzienników w pliku Google Cloud może wiązać się z dodatkowymi kosztami, jeśli przekroczysz limit miejsca na dzienniki.
Więcej informacji o logach znajdziesz w artykule Cloud Logging dlaMatter .
Udostępnianie projektu dewelopera
Możesz przyznawać i odbierać dostęp do projektu użytkownikom w swojej grupie za pomocą zdefiniowanych wstępnie ról.
Na stronie Strona główna w Developer Console kliknij Członkowie, aby otworzyć stronę Google Cloud Console Administracja > Uprawnienia.
Możesz też kliknąć Szczegóły projektu, a potem w sekcji Członkowie na dole kliknąć Zarządzaj użytkownikami w GCP.
W razie potrzeby wprowadź zmiany na Google Cloud Console panelu.
Instrukcje dotyczące modyfikowania dostępu do projektu znajdziesz w artykule Kontrola dostępu do projektów za pomocą uprawnień.
Po dodaniu do listy użytkowników może on wyświetlać projekt i wszystkie integracje w sekcji Developer Console.
W zależności od ustawień organizacji podczas próby tworzenia projektów deweloperskich mogą wystąpić błędy uprawnień. Jeśli tak, skontaktuj się z administratoremGoogle Cloud i poproś o przyznanie Twojemu kontu uprawnień twórcy projektu.