Uzyskiwanie klucza interfejsu API usługi Mapy Google

Artykuł
01/10/2024

Aby korzystać z funkcji google Mapy w systemie Android, musisz zarejestrować się w celu uzyskania klucza interfejsu API Mapy w usłudze Google. Dopóki to nie zrobisz, zobaczysz tylko pustą siatkę zamiast mapy w aplikacjach. Musisz uzyskać klucz interfejsu API systemu Android Mapy Google Mapy w wersji 2 — klucze ze starszego klucza interfejsu API systemu Google Mapy Android v1 nie będą działać.

Uzyskanie klucza interfejsu API Mapy w wersji 2 obejmuje następujące kroki:

Pobierz odcisk palca SHA-1 magazynu kluczy, który jest używany do podpisywania aplikacji.
Utwórz projekt w konsoli interfejsów API Google.
Uzyskiwanie klucza interfejsu API.

Uzyskiwanie odcisku palca klucza podpisywania

Aby zażądać klucza interfejsu API Mapy od firmy Google, musisz znać odcisk palca SHA-1 magazynu kluczy używany do podpisywania aplikacji. Zazwyczaj oznacza to, że należy określić odcisk palca SHA-1 dla magazynu kluczy debugowania, a następnie odcisk palca SHA-1 dla magazynu kluczy, który jest używany do podpisywania aplikacji do wydania.

Program Visual Studio
Visual Studio dla komputerów Mac

Domyślnie magazyn kluczy używany do podpisywania wersji debugowania aplikacji platformy Xamarin.Android można znaleźć w następującej lokalizacji:

C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono dla systemu Android\debug.keystore

Informacje o magazynie kluczy są uzyskiwane przez uruchomienie keytool polecenia z zestawu JDK. To narzędzie zazwyczaj znajduje się w katalogu bin języka Java:

C:\Program Files\Android\jdk\microsoft_dist_openjdk_[VERSION]\bin\keytool.exe

Domyślnie magazyn kluczy używany do podpisywania wersji debugowania aplikacji platformy Xamarin.Android można znaleźć w następującej lokalizacji:

/Users/[USERNAME]/.local/share/Xamarin/Mono dla systemu Android/debug.keystore

Informacje o magazynie kluczy są uzyskiwane przez uruchomienie keytool polecenia z zestawu JDK. To narzędzie zazwyczaj znajduje się w katalogu bin języka Java:

/System/Library/Java/JavaVirtualMachines/[VERSION].jdk/Contents/Home/bin/keytool

Uruchom narzędzia keytool przy użyciu następującego polecenia (przy użyciu ścieżek plików pokazanych powyżej):

keytool -list -v -keystore [STORE FILENAME] -alias [KEY NAME] -storepass [STORE PASSWORD] -keypass [KEY PASSWORD]

Przykład debug.keystore

Dla domyślnego klucza debugowania (który jest automatycznie tworzony na potrzeby debugowania), użyj następującego polecenia:

Program Visual Studio
Visual Studio dla komputerów Mac

keytool.exe -list -v -keystore "C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

keytool -list -v -keystore /Users/[USERNAME]/.local/share/Xamarin/Mono\ for\ Android/debug.keystore -alias androiddebugkey -storepass android -keypass android

Klucze produkcyjne

Podczas wdrażania aplikacji w sklepie Google Play musi być podpisana przy użyciu klucza prywatnego. Element keytool będzie musiał zostać uruchomiony przy użyciu szczegółów klucza prywatnego, a wynikowy odcisk palca SHA-1 użyty do utworzenia produkcyjnego klucza interfejsu API google Mapy. Pamiętaj, aby zaktualizować plik AndroidManifest.xml przy użyciu poprawnego klucza interfejsu API Mapy Google przed wdrożeniem.

Dane wyjściowe narzędzia Keytool

W oknie konsoli powinny zostać wyświetlone dane wyjściowe podobne do następujących:

Alias name: androiddebugkey
Creation date: Jan 01, 2016
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

W dalszej części tego przewodnika użyjesz odcisku palca SHA-1 (wymienionego po sha1).

Tworzenie projektu interfejsu API

Po pobraniu odcisku palca SHA-1 magazynu kluczy podpisywania należy utworzyć nowy projekt w konsoli interfejsów API Google (lub dodać usługę Google Mapy Interfejs API systemu Android w wersji 2 do istniejącego projektu).

W przeglądarce przejdź do pulpitu nawigacyjnego interfejsu API konsoli i usług Google Developers, a następnie kliknij pozycję Wybierz projekt. Kliknij nazwę projektu lub utwórz nowy, klikając pozycję NOWY PROJEKT:
Jeśli utworzono nowy projekt, wprowadź nazwę projektu w wyświetlonym oknie dialogowym Nowy projekt . To okno dialogowe spowoduje utworzenie unikatowego identyfikatora projektu opartego na nazwie projektu. Następnie kliknij przycisk Utwórz , jak pokazano w tym przykładzie:
Po minucie zostanie utworzony projekt i zostanie on przeniesiony na stronę Pulpit nawigacyjny projektu. W tym miejscu kliknij pozycję WŁĄCZ INTERFEJSY API I USŁUGI:
Na stronie Biblioteka interfejsów API kliknij pozycję Mapy SDK dla systemu Android. Na następnej stronie kliknij pozycję WŁĄCZ , aby włączyć usługę dla tego projektu:

Na tym etapie projekt interfejsu API został utworzony, a interfejs API systemu Android w wersji 2 firmy Google Mapy został do niego dodany. Nie można jednak używać tego interfejsu API w projekcie do momentu utworzenia dla niego poświadczeń. W następnej sekcji wyjaśniono, jak utworzyć klucz interfejsu API i autoryzować aplikację platformy Xamarin.Android do korzystania z tego klucza.