Podpisz aplikację

Systemy operacyjne mają nieco odmienne procedury podpisywania, ale koncepcyjnie niczym się między sobą nie różnią. Aplikacje rozpowszechniane do użytku przez innych muszą zostać podpisane. Nawet jeżeli aplikacja ArcGIS AppStudio będzie podpisywać aplikacje i realizować proces budowania, użytkownik musi nadal odbierać pliki z podpisami od każdego sprzedawcy systemu operacyjnego jako dane wejściowe do aplikacji AppStudio.

Tworzenie nowej aplikacji

Przed zarejestrowaniem i opublikowaniem aplikacji powinna ona uzyskać identyfikator klienta systemu ArcGIS, identyfikator przekierowania URI i ciąg znakowy licencji. Aplikacja może zostać utworzona bez identyfikator klienta lub identyfikatora przekierowania URI, jednak obie te informacje są ważne dla aplikacji korzystającej z usług ArcGIS.

Identyfikator klienta ArcGIS — inaczej AppID — jest niezbędny do zalogowania się nazwanego użytkownika do każdej aplikacji. Aby uzyskać identyfikator klienta, przejdź na stronę https://developers.arcgis.com, zaloguj się, używając poświadczeń programisty, kliknij strzałkę listy rozwijanej znajdującą się obok okna Panel i wybierz opcję Nowa aplikacja. Po zarejestrowaniu otrzymasz identyfikator klienta, który możesz skopiować do aplikacji AppStudio. Gdy korzystasz z aplikacji ArcGIS AppStudio, identyfikator klienta możesz też utworzyć za pomocą opcji Ustawienia > Licencjonowanie, klikając przycisk Zarejestruj.

Jeśli aplikacja wymaga logowania się jako nazwany użytkownik, należy także podać identyfikator przekierowania URI. Identyfikatory przekierowania URI określają prawidłowe miejsca, do których będzie przekierowywany użytkownik po ukończeniu logowania OAuth. Aby dodać nowy identyfikator przekierowania URI dla aplikacji, przejdź do karty Uwierzytelnianie dla Twojej aplikacji w witrynie https://developers.arcgis.com. Zarejestruj tam swoją aplikację (o ile nie zostało to jeszcze zrobione) i dodaj własny identyfikator przekierowania URI lub dodaj wpis urn:ietf:wg:oauth:2.0:oob, aby używać hostowanej strony przekierowania z powrotem do aplikacji w usłudze ArcGIS Online. Identyfikator URI urn:ietf:wg:oauth:2.0:oob jest także ustawiany automatycznie dla wszystkich aplikacji utworzonych i zarejestrowanych w aplikacji ArcGIS AppStudio.

Ciąg znakowy licencji jest niezbędny do utworzenia aplikacji korzystających ze środowiska ArcGIS Runtime w wersji 100.x. Aplikacji nie można utworzyć bez ciągu znakowego licencji określającego także funkcje platformy ArcGIS, które mogą być wykonywane przez daną aplikację. Aby uzyskać więcej informacji o uzyskiwaniu ciągu znakowego licencji, zapoznaj się z sekcją Licencjonowanie aplikacji.

Podpisz aplikację dla systemu iOS.

Wszystkie aplikacje w systemie iOS muszą być podpisane. Aplikacje utworzone do testowania muszą być podpisane certyfikatem programisty powiązanym z kontem programisty Apple oraz urządzeniem, na którym wykonano sprawdzenie. Certyfikat produkcyjny jest powiązany wyłącznie do Twojego konta programisty Apple.

Przed uruchomieniem narzędzia Utwórz znajdującego się w panelu bocznym Galeria aplikacji AppStudio (w chmurze lub lokalnie) upewnij się, że na karcie iOS znajdującej się w oknie Ustawienia pod nagłówkiem Platformy wprowadzono:

• Identyfikator zbioru — należy zawsze używać odwróconej nazwy domeny internetowej, na przykład com.companyname.applicationname. Nazwa pakietu to niepowtarzalny identyfikator aplikacji, będący domyślną nazwą procesu aplikacji. Po opublikowaniu aplikacji zmiana nazwy pakietu jest niemożliwa. Aby uzyskać więcej informacji, zapoznaj się z wyjaśnieniami na temat identyfikatora pakietu w sekcji Przygotowanie do dystrybucji aplikacji.
• Profil alokacji — oznacza urządzenia, na którym ma być uruchamiana aplikacja.
• Certyfikat (plik .p12) — certyfikat dla sklepu App Store lub dystrybucji wewnętrznej. Plik jest tworzony w łańcuchu znaków Keychain Access. Jeśli ta informacja oraz identyfikator zbioru nie zostaną podane w aplikacji AppStudio, pliki instalacyjne nie zostaną utworzone. Więcej informacji znajduje się w temacie Czym są podpisy aplikacji?

Podczas działania narzędzia Utwórz zostanie wyświetlone polecenie podania hasła certyfikatu.

Aby utworzyć plik certyfikatu wymagany w celu podpisania, potrzebny jest komputer Mac i każdy programista musi jeden raz przejść przez następujące etapy:

1. Pobierz certyfikat programisty (na przykład, ios_developer.cer) z iOS Dev Center.
2. Pobierz swój profil alokacji mobilnej (na przykład ios_developer.mobileprovision) z iOS Dev Center.
3. Użyj Wyszukiwarki, aby przejść do opcji Aplikacje > Narzędzia > Keychain Access.
4. Przeprowadź importowanie swojego certyfikatu do Keychain Access.
5. W Keychain Access, na liście Keychain wybierz opcję zaloguj, a na liście Kategoria wybierz opcję Moje certyfikaty. Wybierz certyfikat o nazwie zatelefonuj do programisty: Twoje imię i nazwisko i przeprowadź eksportowanie certyfikatu przy pomocy klucza prywatnego z hasłem (na przykład john_doe_private_key.p12).

   Twój plik z certyfikatem jest gotowy.

6. W aplikacji AppStudio przejdź do opcji Ustawienia > Platformy > iOS.
7. Skonfiguruj ścieżkę do profilu udostępniania licencji.
8. Skonfiguruj metodę dystrybucji aplikacji. Więcej informacji o dostępnych opcjach zawiera dokumentacja Xcode dotycząca metod dystrybucji.

Notatka:

Kliknij dwukrotnie plik certyfikatu .p12 i profil alokacji mobilnej, aby zaimportować pliki.

Jeśli korzystasz z aplikacji AppStudio w systemie macOS, skonfiguruj dwie dodatkowe właściwości wymagane do tworzenia aplikacji systemu iOS przy użyciu lokalnego narzędzia Utwórz. Wypełnij te pola, korzystając z danych zawartych w certyfikacie tworzenia lub dystrybucji. Aby go wyświetlić, użyj Wyszukiwarki i przejdź do opcji Aplikacje > Narzędzia > Keychain Access.

W polu Identyfikator zespołu podaj jednostkę organizacyjną certyfikatu.

W polu Tożsamość podpisywania kodu podaj nazwę zwykłą certyfikatu.

Podpisz aplikację dla systemu Android.

Aby przygotować wersję zbudowaną dla systemu Android, należy najpierw wygenerować plik magazynu kluczy podpisywania (keystore). Więcej informacji o tworzeniu tego pliku zawiera dokumentacja systemu Android.

Przed uruchomieniem narzędzia Utwórz (w chmurze lub lokalnie) upewnij się, że na karcie Android znajdującej się w oknie Ustawienia pod nagłówkiem Platformy wprowadzono:

• Nazwa pakietu — należy zawsze używać odwróconej nazwy domeny internetowej, na przykład com.companyname.applicationname. Nazwa pakietu to niepowtarzalny identyfikator aplikacji, będący domyślną nazwą procesu aplikacji. Po opublikowaniu aplikacji zmiana nazwy pakietu jest niemożliwa. Dodatkowe informacje dotyczące nazwy pakietu można znaleźć w temacie poświęconym elementowi manifest w dokumentacji pakietu SDK dla systemu Android.
• Ścieżka pliku magazynu kluczy (keystore) — położenie pliku magazynu kluczy na komputerze użytkownika.
• Alias klucza — nazwa klucza utworzona podczas tworzenia magazynu kluczy.

Jeżeli taka informacja nie jest dostarczona, pliki instalacyjne użytkownika są nadal tworzone, ale nie będą podpisane. Niepodpisane pliki można instalować w celach testowych, ale nie można ich przesyłać do sklepu Google Play lub Amazon Appstore.

Podczas działania narzędzia Utwórz zostanie wyświetlone polecenie podania haseł do magazynu kluczy i do klucza.

Aby utworzyć magazyn kluczy (keystore), należy dla każdego dewelopera jeden raz przejść przez następujące etapy:

1. Pobierz i zainstaluj oprogramowanie Java Development Kit (JDK) z witryny https://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. Utwórz na swoim komputerze zmienną środowiskową o nazwie JAVA_HOME: https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html.
3. Dodaj folder JDK do swojej zmiennej środowiskowej PATH.
4. W oknie poleceń, użyj następującego schematu, by utworzyć klucz: keytool -genkey -v -keystore [keystore_name].keystore -alias [alias_name] -keyalg RSA -keysize 2048 -validity 10000, gdzie keystore_name to nazwa wybrana przez użytkownika z wynikowego pliku magazynu kluczy (keystore), a alias_name to nazwa wybrana przez użytkownika jako alias.
5. Wprowadź hasło magazynu kluczy (keystore) i zatwierdź.
6. Wprowadź dodatkowe informacje i zatwierdź.
7. Wprowadź hasło klucza. Hasło może być unikalne. Aby użyć hasła magazynu kluczy (keystore), naciśnij klawisz Enter.

   Plik magazynu kluczy zostanie utworzony w folderze, w którym zostało uruchomione to polecenie.

Podpisz aplikację dla systemu macOS.

Podobnie jak w przypadku systemu Android, jeśli podczas żądania plików instalacyjnych dla systemu macOS nie zostanie podany certyfikat, pliki zostaną utworzone, ale będą niepodpisane. Niepodpisane pliki można instalować w celach testowych, ale nie można ich przesyłać do sklepu Mac Store. Poniższe instrukcje są podobne jak dla systemu iOS, jednak w przypadku komputerów macOS profil alokacji nie jest wymagany. Więcej informacji znajduje się w temacie Czym są podpisy aplikacji?

Przed uruchomieniem narzędzia Utwórz (w chmurze lub lokalnie) upewnij się, że na karcie macOS znajdującej się w oknie Ustawienia pod nagłówkiem Platformy wprowadzono:

• Identyfikator zbioru — należy zawsze używać odwróconej nazwy domeny internetowej, na przykład com.companyname.applicationname. Nazwa pakietu to niepowtarzalny identyfikator aplikacji, będący domyślną nazwą procesu aplikacji. Po opublikowaniu aplikacji zmiana nazwy pakietu jest niemożliwa. Aby uzyskać więcej informacji, zapoznaj się z wyjaśnieniami na temat identyfikatora pakietu w sekcji Przygotowanie do dystrybucji aplikacji.
• Certyfikat (plik .p12) — certyfikat dla sklepu App Store lub dystrybucji wewnętrznej. Plik jest tworzony w łańcuchu znaków Keychain Access. Jeśli ta informacja oraz identyfikator zbioru nie zostaną podane w aplikacji AppStudio, pliki instalacyjne nie zostaną utworzone. Więcej informacji znajduje się w temacie Czym są podpisy aplikacji?

Podczas działania narzędzia Utwórz zostanie wyświetlone polecenie podania hasła certyfikatu.

Aby utworzyć plik certyfikatu wymagany do podpisywania aplikacji dla systemu macOS, postępuj zgodnie z instrukcjami podanymi powyżej dla aplikacji dla systemu iOS.

Podpisz aplikację dla systemu Windows.

Podobnie jak w przypadku systemu Android, jeśli podczas żądania plików instalacyjnych dla systemu Windows nie zostanie podany certyfikat, pliki zostaną utworzone, ale będą niepodpisane.

Przed uruchomieniem narzędzia Utwórz (w chmurze lub lokalnie) upewnij się, że na karcie Windows znajdującej się w oknie Ustawienia pod nagłówkiem Platformy wprowadzono plik certyfikatu: Ten certyfikat (plik .p12 lub .pfx) jest przeznaczony dla sklepu Windows Store lub na potrzeby dystrybucji wewnętrznej. Więcej informacji zawiera temat Tworzenie certyfikatu do podpisywania pakietu w dokumentacji dewelopera firmy Microsoft.