Ręczna aprowizacja aplikacji systemu iOS

Ręczna aprowizacja to metoda wdrażania aplikacji wieloplatformowej platformy .NET (.NET MAUI) na urządzeniu, na którym masz pełną kontrolę nad tworzonymi danymi aprowizacji. W tym podejściu ręcznie utworzysz tożsamości podpisywania, identyfikatory aplikacji i profile aprowizacji oraz zarządzasz nimi na koncie dewelopera firmy Apple, a następnie musisz pobrać te dane do programu Visual Studio. Przed rozpoczęciem ręcznego procesu aprowizacji upewnij się, że konto dewelopera apple zostało dodane do programu Visual Studio. Aby uzyskać więcej informacji, zobacz Zarządzanie kontami firmy Apple.

Zespoły programistyczne, certyfikaty i profile mogą być zarządzane przez dostęp do sekcji Certyfikaty, Identyfikatory i profile konta dewelopera firmy Apple.

Tworzenie certyfikatu podpisywania

W przypadku ręcznej aprowizacji pierwszym krokiem konfigurowania urządzenia programistycznego jest utworzenie certyfikatu podpisywania, który składa się z certyfikatu programistycznego i klucza prywatnego.

Certyfikaty programistyczne i skojarzone z nimi klucze ustanawiają twoją tożsamość z firmą Apple i kojarzą Cię z określonymi urządzeniami i profilami na potrzeby programowania. Jest to analogiczne do dodawania podpisu cyfrowego do aplikacji. Firma Apple używa tych certyfikatów, aby upewnić się, że aplikacje można wdrażać tylko na określonych urządzeniach.

Ważne

W dowolnym momencie można mieć tylko dwa certyfikaty programistyczne systemu iOS. Jeśli musisz utworzyć więcej, musisz odwołać istniejący. Każda maszyna korzystająca z odwołanego certyfikatu nie będzie mogła podpisać swojej aplikacji.

Po dodaniu konta dewelopera Apple do programu Visual Studio musisz wygenerować certyfikat podpisywania:

1. W programie Visual Studio przejdź do pozycji Narzędzia > Opcje > konta Xamarin > Apple.
2. W oknie dialogowym Konta deweloperów firmy Apple wybierz zespół, a następnie wybierz pozycję Wyświetl szczegóły.
3. W oknie dialogowym Szczegóły wybierz pozycję Utwórz tworzenie certyfikatu>dla systemu iOS. Zostanie utworzona nowa tożsamość podpisywania i zostanie zsynchronizowana z firmą Apple, jeśli masz odpowiednie uprawnienia.

Ważne

Klucz prywatny i certyfikat, który składają się na tożsamość podpisywania, również zostaną wyeksportowane do programu Keychain Access na hoście kompilacji na komputerze Mac, pod warunkiem, że środowisko IDE jest sparowane z nim. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).

Opis par kluczy certyfikatu

Profil dewelopera zawiera certyfikaty, skojarzone z nimi klucze i wszystkie profile aprowizacji skojarzone z kontem dewelopera firmy Apple. Istnieją dwie wersje profilu dewelopera — jedna istnieje na koncie dewelopera firmy Apple, a druga na komputerze lokalnym. Różnica między nimi to typ kluczy, które zawierają: profil na koncie dewelopera firmy Apple zawiera wszystkie klucze publiczne skojarzone z certyfikatami, podczas gdy kopia na komputerze lokalnym zawiera wszystkie klucze prywatne. Aby certyfikaty są prawidłowe, pary kluczy muszą być zgodne.

Ostrzeżenie

Utrata certyfikatu i skojarzonych kluczy może być niezwykle destrukcyjna, ponieważ będzie wymagać cofnięcia istniejących certyfikatów i ponownej aprowizacji wszystkich skojarzonych urządzeń. Po pomyślnym skonfigurowaniu certyfikatu programistycznego w bezpiecznym miejscu wyeksportuj kopię zapasową i zapisz ją w bezpiecznym miejscu. Aby uzyskać więcej informacji na temat tego, jak to zrobić, zobacz Eksportowanie kont deweloperów na help.apple.com.

Aprowizuj urządzenie z systemem iOS na potrzeby programowania

Po utworzeniu certyfikatu podpisywania należy skonfigurować profil aprowizacji programowania, aby można było wdrożyć aplikację na urządzeniu. Na urządzeniu musi być uruchomiona wersja systemu iOS obsługiwana przez program Xcode.

Dodawanie urządzenia

Podczas tworzenia profilu aprowizacji profil musi zawierać urządzenia, na których można uruchomić aplikację. Przed wybraniem urządzenia do dodania do profilu aprowizacji należy najpierw dodać urządzenie do konta dewelopera firmy Apple. Urządzenie można dodać, wykonując następujące czynności:

1. Podłącz urządzenie do aprowizowania lokalnego komputera Mac za pomocą USB.

2. Otwórz program Xcode i przejdź do pozycji Urządzenia okien > i symulatory.

3. W programie Xcode wybierz kartę Urządzenia i wybierz urządzenie z listy połączonych urządzeń.

4. W programie Xcode skopiuj wartość Identyfikator do schowka:

   

5. W przeglądarce internetowej przejdź do sekcji Urządzenia konta dewelopera firmy Apple i kliknij + przycisk.

6. Na stronie Rejestrowanie nowego urządzenia ustaw poprawną platformę i podaj nazwę nowego urządzenia. Następnie wklej identyfikator ze schowka do pola Identyfikator urządzenia (UDID), a następnie kliknij przycisk Kontynuuj:

   

7. Na stronie Rejestrowanie nowego urządzenia przejrzyj informacje, a następnie kliknij pozycję Zarejestruj.

Powtórz poprzednie kroki dla dowolnego urządzenia z systemem iOS, na którym chcesz wdrożyć aplikację .NET MAUI dla systemu iOS.

Tworzenie identyfikatora aplikacji

Po dodaniu urządzenia do konta dewelopera firmy Apple należy utworzyć identyfikator aplikacji. Identyfikator aplikacji jest podobny do ciągu odwrotnego DNS, który jednoznacznie identyfikuje aplikację i powinien być identyczny z identyfikatorem pakietu aplikacji.

Ważne

Identyfikator pakietu dla aplikacji MAUI platformy .NET jest przechowywany w pliku projektu jako właściwość Identyfikator aplikacji. W programie Visual Studio w Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt aplikacji .NET MAUI i wybierz pozycję Właściwości. Następnie przejdź do karty Ogólne udostępnione > usługi MAUI. Pole Identyfikator aplikacji zawiera listę identyfikatora pakietu.

Po zaktualizowaniu wartości pola Identyfikator aplikacji wartość identyfikatora pakietu w pliku Info.plist zostanie automatycznie zaktualizowana.

Istnieją dwa typy identyfikatorów aplikacji:

• Symbol wieloznaczny. Identyfikator aplikacji z symbolami wieloznacznymi umożliwia używanie jednego identyfikatora aplikacji do dopasowania wielu aplikacji i zazwyczaj ma postać com.domainname.*. Identyfikator aplikacji wieloznacznych może służyć do instalowania większości aplikacji na urządzeniu i powinien być używany w przypadku aplikacji, które nie włączają funkcji specyficznych dla aplikacji.
• Wyraźny. Jawny identyfikator aplikacji jest unikatowy dla pojedynczej aplikacji i zazwyczaj ma postać com.domainname.myid. Jawny identyfikator aplikacji umożliwia instalację jednej aplikacji z zgodnym identyfikatorem pakietu na urządzeniu. Jawne identyfikatory aplikacji są zwykle używane w przypadku aplikacji, które umożliwiają korzystanie z funkcji specyficznych dla aplikacji, takich jak Apple Pay lub Game Center.

Zalecaną metodą jest utworzenie wieloznacznych identyfikatorów aplikacji, chyba że aplikacja korzysta z funkcji specyficznych dla aplikacji. Aby uzyskać więcej informacji na temat możliwości, zobacz Możliwości.

Identyfikator aplikacji z symbolami wieloznacznymi można utworzyć, wykonując następujące czynności:

1. W przeglądarce internetowej przejdź do sekcji Identyfikatory konta dewelopera firmy Apple i kliknij + przycisk .

2. Na stronie Rejestrowanie nowego identyfikatora wybierz pozycję Identyfikatory aplikacji i kliknij przycisk Kontynuuj.

3. Na stronie Rejestrowanie nowego identyfikatora wybierz typ aplikacji i kliknij przycisk Kontynuuj.

4. Na stronie Rejestrowanie identyfikatora aplikacji podaj opis i ustaw identyfikator pakietu na symbol wieloznaczny. Następnie wprowadź identyfikator aplikacji w formacie com.domainname.* i kliknij przycisk Kontynuuj :

   

5. Na stronie Potwierdzanie identyfikatora aplikacji przejrzyj informacje, a następnie kliknij przycisk Zarejestruj.

Tworzenie profilu aprowizacji programowania

Po utworzeniu identyfikatora aplikacji należy utworzyć profil aprowizacji programowania. Profil aprowizacji zawiera informacje o aplikacji (lub aplikacjach, jeśli jest to identyfikator aplikacji wieloznacznych), do którego odnosi się profil, który może używać profilu (w zależności od dodanych certyfikatów deweloperów) oraz urządzeń, które mogą zainstalować aplikację.

Profil aprowizacji programowania można utworzyć, wykonując następujące czynności:

1. W przeglądarce internetowej przejdź do sekcji Profile konta dewelopera firmy Apple i kliknij + przycisk .

2. Na stronie Rejestrowanie nowego profilu aprowizacji w sekcji Programowanie wybierz pozycję Tworzenie aplikacji systemu iOS i kliknij przycisk Kontynuuj:

   

3. Na stronie Generowanie profilu aprowizacji wybierz identyfikator aplikacji do użycia, a następnie kliknij przycisk Kontynuuj.

   

4. Na stronie Generowanie profilu aprowizacji wybierz certyfikaty do uwzględnienia w profilu aprowizacji, a następnie kliknij przycisk Kontynuuj.

   

5. Na stronie Generowanie profilu aprowizacji wybierz urządzenia, na których zostanie zainstalowana aplikacja, a następnie kliknij przycisk Kontynuuj.

   

6. Na stronie Generowanie profilu aprowizacji podaj nazwę profilu aprowizacji, a następnie kliknij przycisk Generuj.

   

7. Na stronie Generowanie profilu aprowizacji możesz opcjonalnie kliknąć przycisk Pobierz, aby pobrać profil aprowizacji.

Pobieranie profilów aprowizacji w programie Visual Studio

Po utworzeniu profilu aprowizacji programowania na koncie dewelopera firmy Apple program Visual Studio może go pobrać, aby był dostępny do podpisywania aplikacji:

1. W programie Visual Studio przejdź do pozycji Narzędzia > Opcje > konta Xamarin > Apple.
2. W oknie dialogowym Konta deweloperów firmy Apple wybierz zespół i kliknij przycisk Wyświetl szczegóły...
3. W oknie dialogowym Szczegóły sprawdź, czy nowy profil jest wyświetlany na liście Profile aprowizacji. Aby odświeżyć listę, może być konieczne ponowne uruchomienie programu Visual Studio.
4. W oknie dialogowym Szczegóły kliknij przycisk Pobierz wszystkie profile.

Profile aprowizacji zostaną pobrane w systemie Windows i wyeksportowane na hosta kompilacji dla komputerów Mac, jeśli środowisko IDE zostanie sparowane. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).

Włączanie ręcznej aprowizacji

Po ręcznym utworzeniu profilu aprowizacji programowania i zainstalowaniu go w programie Visual Studio projekt aplikacji .NET MAUI powinien być skonfigurowany do ręcznego aprowizowania:

1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt aplikacji .NET MAUI i wybierz pozycję Właściwości. Następnie przejdź do karty Ogólne udostępnione > usługi MAUI i upewnij się, że wartość pola Identyfikator aplikacji odpowiada formatowi utworzonego wcześniej identyfikatora aplikacji.

2. We właściwościach projektu przejdź do karty Podpisywanie pakietu systemu iOS i upewnij się, że na liście rozwijanej Schemat wybrano opcję Ręczne aprowizowanie:

   

3. We właściwościach Podpisywanie pakietu wybierz pozycję Tożsamość podpisywania i Profil aprowizacji lub ustaw obie wartości na Wartość Automatyczna. Gdy tożsamość podpisywania i profil aprowizacji są ustawione na Wartość Automatyczna, program Visual Studio wybierze tożsamość podpisywania i profil aprowizacji na podstawie identyfikatora pakietu w pliku Info.plist (który jest identyczny z wartością właściwości Identyfikator aplikacji w pliku projektu).

Wdrażanie na urządzeniu

Po skonfigurowaniu aprowizacji w projekcie aplikacji .NET MAUI można wdrożyć aplikację na urządzeniu za pomocą programu Visual Studio:

1. W programie Visual Studio upewnij się, że środowisko IDE jest sparowane z hostem kompilacji dla komputerów Mac. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).

2. Upewnij się, że urządzenie z systemem iOS jest podłączone do hosta kompilacji dla komputerów Mac za pośrednictwem portu USB lub sieci Wi-Fi. Aby uzyskać więcej informacji na temat wdrażania bezprzewodowego, zobacz Wdrażanie bezprzewodowe dla aplikacji .NET MAUI systemu iOS.

3. Na pasku narzędzi programu Visual Studio użyj listy rozwijanej Debuguj element docelowy , aby wybrać pozycję Urządzenia zdalne z systemem iOS, a następnie urządzenie połączone z hostem kompilacji dla komputerów Mac:

   

4. Na pasku narzędzi programu Visual Studio naciśnij zielony przycisk Start, aby uruchomić aplikację na urządzeniu zdalnym:

   

Uwaga

Alternatywną metodą wdrażania aplikacji .NET MAUI dla systemu iOS na urządzeniu jest użycie gorącego ponownego uruchamiania. Ponowne uruchamianie na gorąco umożliwia wdrożenie aplikacji .NET MAUI na 64-bitowym lokalnym urządzeniu z systemem iOS z poziomu programu Visual Studio bez konieczności posiadania hosta kompilacji na komputerze Mac. Aby uzyskać więcej informacji, zobacz Wdrażanie aplikacji systemu iOS przy użyciu ponownego uruchamiania na gorąco.

Inicjowanie obsługi administracyjnej usług aplikacji

Firma Apple oferuje wybór usług aplikacji, znanych jako możliwości, które można aktywować dla aplikacji .NET MAUI dla systemu iOS. Te możliwości należy skonfigurować zarówno w profilu aprowizacji, po utworzeniu identyfikatora aplikacji, jak i w pliku Entitlements.plist , który powinien zostać dodany do projektu aplikacji .NET MAUI. Aby uzyskać więcej informacji na temat możliwości, zobacz Uprawnienia i możliwości.