Publikowanie aplikacji Katalizator dla komputerów Mac na potrzeby dystrybucji ad hoc

• Publikowanie niepodpisanej aplikacji
• Publikowanie dla dystrybucji sklepu z aplikacjami
• Publikowanie poza sklepem z aplikacjami

Podczas dystrybucji aplikacji Mac Catalyst poza sklepem Mac App Store można również dystrybuować aplikację do ograniczonej liczby użytkowników na zarejestrowanych urządzeniach. Jest to nazywane dystrybucją ad hoc i jest używane głównie do testowania aplikacji w grupie osób. Jest to jednak ograniczone do 100 urządzeń rocznie członkostwa, a urządzenia muszą zostać dodane do konta dewelopera firmy Apple. Członkowie programu Apple Developer Program i programu Apple Developer Enterprise Program mogą korzystać z tej metody dystrybucji.

Dystrybucja aplikacji Mac Catalyst wymaga aprowizacji aplikacji przy użyciu profilu aprowizacji. Profile aprowizacji to pliki zawierające informacje o podpisywaniu kodu, a także tożsamość aplikacji i jej zamierzony mechanizm dystrybucji.

Aby dystrybuować aplikację Mac Catalyst interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI) poza sklepem Mac App Store przy użyciu dystrybucji ad hoc, należy utworzyć profil aprowizacji programowania specyficzny dla niej. Ten profil umożliwia cyfrowe podpisanie aplikacji na potrzeby wydania, dzięki czemu można ją zainstalować na komputerach Mac. Profil aprowizacji programowania ad hoc zawiera identyfikator aplikacji, certyfikat programowania i listę urządzeń, które mogą zainstalować aplikację. Jeśli jeszcze go nie masz, musisz utworzyć certyfikat dewelopera, aby zidentyfikować siebie lub organizację.

Proces aprowizacji aplikacji .NET MAUI Mac Catalyst dla dystrybucji ad hoc jest następujący:

1. Utwórz żądanie podpisania certyfikatu. Aby uzyskać więcej informacji, zobacz Tworzenie żądania podpisania certyfikatu.
2. Utwórz certyfikat dewelopera. Aby uzyskać więcej informacji, zobacz Tworzenie certyfikatu programistycznego.
3. Utwórz identyfikator aplikacji. Aby uzyskać więcej informacji, zobacz Tworzenie identyfikatora aplikacji.
4. Dodaj urządzenia do konta dewelopera firmy Apple. Aby uzyskać więcej informacji, zobacz Dodawanie urządzeń.
5. Utwórz profil aprowizacji. Aby uzyskać więcej informacji, zobacz Tworzenie profilu aprowizacji.
6. Pobierz profil aprowizacji. Aby uzyskać więcej informacji, zobacz Pobieranie profilu aprowizacji w środowisku Xcode.

Ważne

W tym artykule przedstawiono aprowizowanie dystrybucji ad hoc przy użyciu konta dewelopera apple będącego częścią programu Apple Developer Program. Można go również użyć dla konta dewelopera Apple, które jest częścią programu Apple Developer Enterprise Program, ponieważ wymagane kroki są w dużej mierze identyczne.

Następnie po zakończeniu aprowizacji należy przygotować aplikację do publikowania, a następnie opublikować ją przy użyciu następującego procesu:

1. Opcjonalnie dodaj uprawnienia do aplikacji. Aby uzyskać więcej informacji, zobacz Dodawanie uprawnień.
2. Zaktualizuj plik Info.plist aplikacji. Aby uzyskać więcej informacji, zobacz Update Info.plist (Aktualizowanie pliku Info.plist).
3. Opublikuj aplikację przy użyciu wiersza polecenia. Aby uzyskać więcej informacji, zobacz Publikowanie przy użyciu wiersza polecenia.

Tworzenie żądania podpisania certyfikatu

Przed utworzeniem certyfikatu dystrybucji należy najpierw utworzyć żądanie podpisania certyfikatu (CSR) w programie Keychain Access na komputerze Mac:

1. Na komputerze Mac uruchom program Keychain Access.

2. W obszarze Dostęp do pęku kluczy wybierz asystenta > certyfikatów dostępu > łańcucha kluczy zażądać certyfikatu z poziomu elementu menu Urząd certyfikacji... .

3. W oknie dialogowym Asystent certyfikatów wprowadź adres e-mail w polu Adres e-mail użytkownika.

4. W oknie dialogowym Asystent certyfikatów wprowadź nazwę klucza w polu Nazwa pospolita.

5. W oknie dialogowym Asystent certyfikatów pozostaw puste pole Adres e-mail urzędu certyfikacji.

6. W oknie dialogowym Asystent certyfikatów wybierz przycisk radiowy Zapisane na dysku i wybierz pozycję Kontynuuj:

   

7. Zapisz żądanie podpisania certyfikatu w znanej lokalizacji.

8. W oknie dialogowym Asystent certyfikatów wybierz przycisk Gotowe.

9. Zamknij pozycję Dostęp pęku kluczy.

Tworzenie certyfikatu programistycznego

Csr umożliwia wygenerowanie certyfikatu programistycznego, który potwierdza twoją tożsamość. Certyfikat dewelopera należy utworzyć przy użyciu identyfikatora Apple ID dla konta dewelopera firmy Apple:

1. W przeglądarce internetowej zaloguj się do konta dewelopera firmy Apple.

2. Na koncie dewelopera firmy Apple wybierz kartę Certyfikaty, Identyfikatory i profile .

3. Na stronie Certyfikaty, identyfikatory i profile wybierz + przycisk, aby utworzyć nowy certyfikat.

4. Na stronie Tworzenie nowego certyfikatu wybierz przycisk radiowy Programowanie firmy Apple przed wybraniem przycisku Kontynuuj:

   

5. Na stronie Tworzenie nowego certyfikatu wybierz pozycję Wybierz plik:

   

6. W oknie dialogowym Wybieranie plików do przekazania wybierz utworzony wcześniej plik żądania certyfikatu (plik z .certSigningRequest rozszerzeniem pliku), a następnie wybierz pozycję Przekaż.

7. Na stronie Tworzenie nowego certyfikatu wybierz przycisk Kontynuuj:

   

8. Na stronie Pobierz certyfikat wybierz przycisk Pobierz:

   

   Plik certyfikatu (plik z rozszerzeniem) zostanie pobrany do wybranej .cer lokalizacji.

9. Na komputerze Mac kliknij dwukrotnie pobrany plik certyfikatu, aby zainstalować certyfikat w pęku kluczy. Certyfikat jest wyświetlany w kategorii Moje certyfikaty w obszarze Dostęp do łańcucha kluczy i rozpoczyna się od programowania apple:

   

   Uwaga

   Zanotuj pełną nazwę certyfikatu w programie Keychain Access. Będzie to wymagane podczas podpisywania aplikacji.

Tworzenie profilu programistycznego

Profil aprowizacji programowania ad hoc umożliwia cyfrowe podpisanie aplikacji .NET MAUI Mac Catalyst, dzięki czemu można ją zainstalować na określonych komputerach Mac. Profil aprowizacji programowania ad hoc zawiera identyfikator aplikacji, certyfikat programowania i listę urządzeń, które mogą zainstalować aplikację.

Tworzenie identyfikatora aplikacji

Identyfikator aplikacji jest wymagany do zidentyfikowania dystrybuowanych aplikacji. Identyfikator aplikacji jest podobny do ciągu odwrotnego DNS, który jednoznacznie identyfikuje aplikację i powinien być identyczny z identyfikatorem pakietu aplikacji. Na potrzeby testowania możesz użyć tego samego identyfikatora aplikacji, który został użyty podczas wdrażania aplikacji na urządzeniu.

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 z symbolami wieloznacznymi może służyć do dystrybucji wielu aplikacji i powinien być używany w przypadku aplikacji, które nie umożliwiają obsługi 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 dystrybucję jednej aplikacji z pasującym identyfikatorem pakietu. 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. Aby uzyskać więcej informacji na temat możliwości, zobacz Możliwości.

Aby utworzyć nowy identyfikator aplikacji:

1. Na koncie dewelopera firmy Apple przejdź do pozycji Certyfikaty, identyfikatory i profile.

2. Na stronie Certyfikaty, Identyfikatory i profile wybierz kartę Identyfikatory .

3. Na stronie Identyfikatory wybierz + przycisk , aby utworzyć nowy identyfikator aplikacji.

4. Na stronie Rejestrowanie nowego identyfikatora wybierz przycisk radiowy Identyfikatory aplikacji przed wybraniem przycisku Kontynuuj:

   

5. Na stronie Rejestrowanie nowego identyfikatora wybierz pozycję Aplikacja przed wybraniem przycisku Kontynuuj:

   

6. Na stronie Rejestrowanie identyfikatora aplikacji wprowadź opis i wybierz przycisk radiowy Jawny lub Wieloznaczny identyfikator pakietu. Następnie wprowadź identyfikator pakietu dla aplikacji w odwrotnym formacie DS:

   

   Ważne

   Wprowadzony identyfikator pakietu musi odpowiadać identyfikatorowi pakietu w pliku Info.plist w projekcie aplikacji.

   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.

7. Na stronie Rejestrowanie identyfikatora aplikacji wybierz wszystkie możliwości używane przez aplikację. Wszystkie możliwości należy skonfigurować zarówno na tej stronie, jak i w pliku Entitlements.plist w projekcie aplikacji. Aby uzyskać więcej informacji, zobacz Możliwości i uprawnienia.

8. Na stronie Rejestrowanie identyfikatora aplikacji wybierz przycisk Kontynuuj.

9. Na stronie Potwierdzanie identyfikatora aplikacji wybierz przycisk Zarejestruj.

Dodawanie urządzeń

Podczas tworzenia profilu aprowizacji dla dystrybucji ad hoc profil musi zawierać urządzenia, które mogą uruchamiać aplikację. Przed wybraniem urządzeń do dodania do profilu aprowizacji należy najpierw dodać urządzenia do konta dewelopera firmy Apple. Można to osiągnąć, wykonując następujące czynności:

1. Wybierz element > menu Apple About this Mac (Informacje o tym komputerze Mac).

2. Na karcie Przegląd wybierz przycisk Raport systemowy... .

3. W raporcie systemowym wybierz rozszerzenie Sprzęt, aby wyświetlić przegląd sprzętu. Raport wyświetla unikatowy identyfikator (UUID) jako identyfikator UUID sprzętu w systemie macOS 10.15 i starszych lub Aprowizowanie identyfikatora UDID w systemie macOS 11.0 lub nowszym.

4. Wybierz wartość Identyfikator UUID sprzętu lub Identyfikator UDID aprowizacji i skopiuj ją 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 wartość Platforma na macOS i podaj nazwę nowego urządzenia. Następnie wklej identyfikator ze schowka do pola Identyfikator urządzenia (UUID), a następnie kliknij przycisk Kontynuuj :

   

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

Powtórz powyższe kroki dla wszystkich komputerów Mac, które chcesz wdrożyć aplikację .NET MAUI Mac Catalyst do korzystania z dystrybucji ad hoc.

Tworzenie profilu aprowizacji

Po utworzeniu identyfikatora aplikacji należy utworzyć profil aprowizacji programowania. Ten profil umożliwia podpisowi cyfrowemu aplikację, dzięki czemu można ją zainstalować na określonych komputerach Mac.

Aby utworzyć profil aprowizacji dla dystrybucji ad hoc:

1. Na stronie Certyfikaty, identyfikatory i profile konta dewelopera firmy Apple wybierz kartę Profile .

2. Na karcie Profile kliknij + przycisk , aby utworzyć nowy profil.

3. Na stronie Rejestrowanie nowego profilu aprowizacji wybierz przycisk radiowy Tworzenie aplikacji dla systemu macOS przed kliknięciem przycisku Kontynuuj :

   

4. Na stronie Generowanie profilu aprowizacji wybierz przycisk radiowy Mac Catalyst. Następnie z listy rozwijanej Identyfikator aplikacji wybierz wcześniej utworzony identyfikator aplikacji przed kliknięciem przycisku Kontynuuj :

   

5. Na stronie Generowanie profilu aprowizacji zaznacz pole wyboru odpowiadające certyfikatowi programistycznemu przed kliknięciem przycisku Kontynuuj:

   

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

   

7. Na stronie Generowanie profilu aprowizacji wprowadź nazwę profilu aprowizacji przed kliknięciem przycisku Generuj:

   

   Uwaga

   Zanotuj nazwę profilu aprowizacji, ponieważ będzie ona wymagana podczas podpisywania aplikacji.

8. Na stronie Generowanie profilu aprowizacji opcjonalnie kliknij przycisk Pobierz, aby pobrać profil aprowizacji.

   Uwaga

   Teraz nie trzeba pobierać profilu aprowizacji. Zamiast tego zrobisz to w środowisku Xcode.

Pobieranie profilu aprowizacji w środowisku Xcode

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

1. Na komputerze Mac uruchom program Xcode.

2. W programie Xcode wybierz element menu Preferencje programu Xcode > ... .

3. W oknie dialogowym Preferencje wybierz kartę Konta.

4. Na karcie Konta kliknij + przycisk , aby dodać konto dewelopera Apple do programu Xcode:

   

5. W oknie podręcznym typ konta wybierz pozycję Apple ID , a następnie kliknij przycisk Kontynuuj :

   

6. W oknie podręcznym logowania wprowadź swój identyfikator Apple ID i kliknij przycisk Dalej .

7. W oknie podręcznym logowania wprowadź hasło identyfikatora Apple ID i kliknij przycisk Dalej :

   

8. Na karcie Konta kliknij przycisk Zarządzaj certyfikatami... , aby upewnić się, że certyfikat dystrybucji został pobrany.

9. Na karcie Konta kliknij przycisk Pobierz profile ręczne, aby pobrać profile aprowizacji:

   

10. Poczekaj na zakończenie pobierania, a następnie zamknij program Xcode.

Dodawanie uprawnień

Piaskownica aplikacji firmy Apple ogranicza dostęp do zasobów systemowych i danych użytkownika w aplikacjach dla komputerów Mac, aby zawierać uszkodzenia w przypadku naruszenia zabezpieczeń aplikacji. Musi być włączona dla aplikacji Katalizator dla komputerów Mac dystrybuowanych za pośrednictwem sklepu Mac App Store i opcjonalnie można ją włączyć dla aplikacji Mac Catalyst, które są dystrybuowane poza sklepem Mac App Store.

Można to osiągnąć, dodając plik Entitlements.plist do folderu Platforms/MacCatalyst projektu aplikacji .NET MAUI:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
  </dict>
</plist>

Uprawnienie piaskownicy aplikacji jest definiowane przy użyciu com.apple.security.app-sandbox klucza typu boolean. Aby uzyskać informacje na temat piaskownicy aplikacji, zobacz Ochrona danych użytkownika za pomocą piaskownicy aplikacji w developer.apple.com. Aby uzyskać informacje o uprawnieniach piaskownicy aplikacji, zobacz Uprawnienia piaskownicy aplikacji.

Jeśli aplikacja otworzy wychodzące połączenia sieciowe, musisz również dodać com.apple.security.network.client klucz typu boolean, do pliku Entitlements.plist :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
    <key>com.apple.security.network.client</key>
    <true/>
  </dict>
</plist>

Aby uzyskać informacje o upoważnieniu wychodzących połączeń sieciowych, zobacz com.apple.security.network.client w developer.apple.com.

Aktualizowanie pliku Info.plist

Przed dystrybucją aplikacji należy zaktualizować jego plik Info.plist o dodatkowe informacje.

Uwaga

Chociaż nie jest wymagane zaktualizowanie pliku Info.plist aplikacji podczas jego dystrybucji na potrzeby testowania, te aktualizacje będą wymagane podczas dystrybucji ostatecznej przetestowanej wersji aplikacji. W związku z tym najlepszym rozwiązaniem jest wykonanie tych aktualizacji.

Określanie idiomu interfejsu użytkownika

Aplikacja Mac Catalyst może działać w idiom interfejsu użytkownika iPad lub Mac:

• Idiom interfejsu użytkownika tabletu iPad nakazuje systemowi macOS skalowanie interfejsu użytkownika aplikacji w celu dopasowania środowiska wyświetlania komputerów Mac przy jednoczesnym zachowaniu wyglądu przypominającego tablet iPad.
• Idiom interfejsu użytkownika dla komputerów Mac nie skaluje interfejsu użytkownika aplikacji w celu dopasowania go do środowiska wyświetlania komputerów Mac. Niektóre kontrolki zmieniają swój rozmiar i wygląd i współdziałają z nimi tak samo, jak w przypadku interakcji z kontrolkami AppKit .

Domyślnie aplikacje .NET MAUI Mac Catalyst używają idiomu interfejsu użytkownika tabletu iPad. Jeśli jest to żądane zachowanie, upewnij się, że plik Info.plist aplikacji określa tylko 2 jako wartość UIDeviceFamily klucza:

<key>UIDeviceFamily</key>
<array>
  <integer>2</integer>
</array>

Aby wdrożyć idiom interfejsu użytkownika dla komputerów Mac, zaktualizuj plik Info.plist aplikacji, aby określić wartość 6 jako wartość UIDeviceFamily klucza:

<key>UIDeviceFamily</key>
<array>
  <integer>6</integer>
</array>

Aby uzyskać więcej informacji na temat idiomów interfejsu użytkownika Narzędzia Mac Catalyst, zobacz Określanie idiom interfejsu użytkownika dla aplikacji Mac Catalyst.

Ustawianie domyślnego języka i regionu dla aplikacji

CFBundleDevelopmentRegion Ustaw klucz w pliku Info.plist aplikacji na wartość string , która reprezentuje region programowania natywnego lokalizacji:

<key>CFBundleDevelopmentRegion</key>
<string>en</string>

Wartość klucza powinna być projektantem języka z opcjonalnym projektantem regionu. Aby uzyskać więcej informacji, zobacz CFBundleDevelopmentRegion w developer.apple.com.

Ustawianie klucza praw autorskich

NSHumanReadableCopyright Ustaw klucz w pliku Info.plist aplikacji na wartość string reprezentującą czytelne dla człowieka powiadomienie o prawach autorskich dla aplikacji:

<key>NSHumanReadableCopyright</key>
<string>MyMauiApp © 2023</string>

Aby uzyskać więcej informacji, zobacz NSHumanReadableCopyright w developer.apple.com.

Deklarowanie użycia szyfrowania aplikacji

Jeśli aplikacja korzysta z szyfrowania i planujesz rozpowszechnić ją poza Stany Zjednoczone lub Kanadą, będzie ona objęta wymaganiami dotyczącymi zgodności eksportu w STANACH Zjednoczonych. Informacje o użyciu szyfrowania w pliku Info.plist można podać w aplikacji.

Jest to realizowane przez dodanie ITSAppUsesNonExemptEncryption klucza do pliku Info.plist aplikacji z wartością wskazującąboolean, czy aplikacja używa szyfrowania:

<key>ITSAppUsesNonExemptEncryption</key>
<false/>

Aby uzyskać więcej informacji, zobacz Zgodność z przepisami dotyczącymi eksportu szyfrowania w developer.apple.com.

Publikowanie przy użyciu wiersza polecenia

Aby opublikować aplikację Mac Catalyst z poziomu wiersza polecenia na komputerze Mac, otwórz terminal i przejdź do folderu dla projektu aplikacji .NET MAUI. dotnet publish Uruchom polecenie , podając następujące parametry:

Parametr	Wartość
-f lub --framework	Struktura docelowa, czyli net8.0-maccatalyst.
-c lub --configuration	Konfiguracja kompilacji, czyli Release.
-p:MtouchLink	Tryb linku dla projektu, który może być None, SdkOnlylub Full.
-p:CreatePackage	Ustaw wartość na true , aby pakiet (.pkg) został utworzony dla aplikacji na końcu kompilacji.
-p:EnableCodeSigning	Ustaw wartość na true , aby włączono podpisywanie kodu.
-p:CodesignKey	Nazwa klucza podpisywania kodu. Ustaw nazwę certyfikatu dystrybucji, jak pokazano w sekcji Dostęp do pęku kluczy.
-p:CodesignProvision	Profil aprowizacji do użycia podczas podpisywania pakietu aplikacji.
-p:CodesignEntitlements	Ścieżka do pliku uprawnień, który określa uprawnienia wymagane przez aplikację. Ustaw wartość Platforms\MacCatalyst\Entitlements.plist.
-p:RuntimeIdentifier	Identyfikator środowiska uruchomieniowego (RID) dla projektu. Wersje kompilacji aplikacji .NET MAUI Mac Catalyst domyślnie używają maccatalyst-x64 identyfikatorów środowiska uruchomieniowego i maccatalyst-arm64 jako identyfikatorów środowiska uruchomieniowego do obsługi uniwersalnych aplikacji. Aby obsługiwać tylko jedną architekturę, określ maccatalyst-x64 wartość lub maccatalyst-arm64.
-p:UseHardenedRuntime	Ustaw wartość na wartość , aby true włączyć środowisko uruchomieniowe ze wzmocnionym zabezpieczeniami, które jest wymagane w przypadku aplikacji Katalizator dla komputerów Mac, które są dystrybuowane poza sklepem Mac App Store.

Ostrzeżenie

Próba opublikowania rozwiązania MAUI platformy .NET spowoduje dotnet publish , że polecenie podejmie próbę opublikowania każdego projektu w rozwiązaniu osobno, co może powodować problemy podczas dodawania innych typów projektów do rozwiązania. W związku z dotnet publish tym polecenie powinno być ograniczone do projektu aplikacji .NET MAUI.

Dodatkowe parametry kompilacji można określić w wierszu polecenia, jeśli nie są one podane w <PropertyGroup> pliku projektu. W poniższej tabeli wymieniono niektóre typowe parametry:

Parametr	Wartość
-p:ApplicationTitle	Nazwa widoczna dla użytkownika dla aplikacji.
-p:ApplicationId	Unikatowy identyfikator aplikacji, taki jak com.companyname.mymauiapp.
-p:ApplicationVersion	Wersja kompilacji identyfikującej iterację aplikacji.
-p:ApplicationDisplayVersion	Numer wersji aplikacji.
-p:RuntimeIdentifier	Identyfikator środowiska uruchomieniowego (RID) dla projektu. Wersje kompilacji aplikacji .NET MAUI Mac Catalyst domyślnie używają maccatalyst-x64 identyfikatorów środowiska uruchomieniowego i maccatalyst-arm64 jako identyfikatorów środowiska uruchomieniowego do obsługi uniwersalnych aplikacji. Aby obsługiwać tylko jedną architekturę, określ maccatalyst-x64 wartość lub maccatalyst-arm64.

Aby uzyskać pełną listę właściwości kompilacji, zobacz Właściwości pliku projektu.

Ważne

Wartości dla wszystkich tych parametrów nie muszą być podane w wierszu polecenia. Można je również udostępnić w pliku projektu. Jeśli parametr jest udostępniany w wierszu polecenia i w pliku projektu, parametr wiersza polecenia ma pierwszeństwo. Aby uzyskać więcej informacji na temat udostępniania właściwości kompilacji w pliku projektu, zobacz Definiowanie właściwości kompilacji w pliku projektu.

Na przykład użyj następującego polecenia, aby skompilować i podpisać .pkg na komputerze Mac w celu dystrybucji ad hoc dla użytkowników na zarejestrowanych urządzeniach:

dotnet publish -f net8.0-maccatalyst -c Release -p:MtouchLink=SdkOnly -p:CreatePackage=true -p:EnableCodeSigning=true  -p:CodesignKey="Apple Development: John Smith (AY2GDE9QM7)" -p:CodesignProvision="MyMauiApp (Ad-hoc)" -p:CodesignEntitlements="Platforms\MacCatalyst\Entitlements.plist" -p:UseHardenedRuntime=true

Uwaga

W programie .NET 8 dotnet publish polecenie jest domyślnie ustawione na konfigurację Release . W związku z tym konfigurację kompilacji można pominąć z wiersza polecenia.

Publikowanie kompilacji, znaków i pakietów aplikacji, a następnie kopiuje .pkg do folderu bin/Release/net8.0-maccatalyst/publish/ . Jeśli opublikujesz aplikację przy użyciu tylko jednej architektury, zostanie ona opublikowana w folderze bin/Release/net8.0-maccatalyst/{architecture}/publish/ .

Podczas procesu podpisywania może być konieczne wprowadzenie hasła logowania i zezwolenie codesign na uruchamianie:

Aby uzyskać więcej informacji o poleceniu dotnet publish , zobacz dotnet publish (Publikowanie dotnet).

Definiowanie właściwości kompilacji w pliku projektu

Alternatywą do określenia parametrów kompilacji w wierszu polecenia jest określenie ich w pliku projektu w pliku <PropertyGroup>. W poniższej tabeli wymieniono niektóre typowe właściwości kompilacji:

Właściwości	Wartość
<ApplicationTitle>	Nazwa widoczna dla użytkownika dla aplikacji.
<ApplicationId>	Unikatowy identyfikator aplikacji, taki jak com.companyname.mymauiapp.
<ApplicationVersion>	Wersja kompilacji identyfikującej iterację aplikacji.
<ApplicationDisplayVersion>	Numer wersji aplikacji.
<CodesignKey>	Nazwa klucza podpisywania kodu. Ustaw nazwę certyfikatu dystrybucji, jak pokazano w sekcji Dostęp do pęku kluczy.
<CodesignEntitlements>	Ścieżka do pliku uprawnień, który określa uprawnienia wymagane przez aplikację. Ustaw wartość Platforms\MacCatalyst\Entitlements.plist.
<CodesignProvision>	Profil aprowizacji do użycia podczas podpisywania pakietu aplikacji.
<CreatePackage>	Ustaw wartość na true , aby pakiet (.pkg) został utworzony dla aplikacji na końcu kompilacji.
<EnableCodeSigning>	Ustaw wartość na true , aby włączono podpisywanie kodu.
<MtouchLink>	Tryb linku dla projektu, który może być None, SdkOnlylub Full.
<RuntimeIdentifier>	Identyfikator środowiska uruchomieniowego (RID) dla projektu. Wersje kompilacji aplikacji .NET MAUI Mac Catalyst domyślnie używają maccatalyst-x64 identyfikatorów środowiska uruchomieniowego i maccatalyst-arm64 jako identyfikatorów środowiska uruchomieniowego do obsługi uniwersalnych aplikacji. Aby obsługiwać tylko jedną architekturę, określ maccatalyst-x64 wartość lub maccatalyst-arm64.
<UseHardenedRuntime>	Ustaw wartość na wartość , aby true włączyć środowisko uruchomieniowe ze wzmocnionym zabezpieczeniami, które jest wymagane w przypadku aplikacji Katalizator dla komputerów Mac, które są dystrybuowane poza sklepem Mac App Store.

Aby uzyskać pełną listę właściwości kompilacji, zobacz Właściwości pliku projektu.

Ważne

Wartości tych właściwości kompilacji nie muszą być podane w pliku projektu. Można je również udostępnić w wierszu polecenia podczas publikowania aplikacji. Dzięki temu można pominąć określone wartości z pliku projektu.

Poniższy przykład przedstawia typową grupę właściwości do kompilowania i podpisywania aplikacji Mac Catalyst na potrzeby dystrybucji ad hoc dla użytkowników na zarejestrowanych urządzeniach:

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-maccatalyst|AnyCPU'">
  <MtouchLink>SdkOnly</MtouchLink>
  <EnableCodeSigning>True</EnableCodeSigning>
  <CreatePackage>true</CreatePackage>
  <CodesignKey>Apple Development: John Smith (AY2GDE9QM7)</CodesignKey>
  <CodesignProvision>MyMauiApp (Ad-hoc)</CodesignProvision>
  <CodesignEntitlements>Platforms\MacCatalyst\Entitlements.plist</CodesignEntitlements>
  <UseHardenedRuntime>true</UseHardenedRuntime>
</PropertyGroup>

W tym przykładzie <PropertyGroup> dodano sprawdzanie warunku, co uniemożliwia przetworzenie ustawień, chyba że sprawdzanie warunku zostanie pomyślnie zrealizowane. Sprawdzanie warunku wyszukuje dwa elementy:

1. Konfiguracja kompilacji jest ustawiona na Releasewartość .
2. Platforma docelowa jest ustawiona na wartość zawierającą tekst net8.0-maccatalyst.
3. Platforma jest ustawiona na AnyCPUwartość .

Jeśli którykolwiek z tych warunków nie powiedzie się, ustawienia nie są przetwarzane. Co ważniejsze, <CodesignKey> ustawienia i <CodesignProvision> nie są ustawione, uniemożliwiając podpisanie aplikacji.

Po dodaniu powyższej grupy właściwości aplikację można opublikować z poziomu wiersza polecenia na komputerze Mac, otwierając terminal i przechodząc do folderu projektu aplikacji .NET MAUI. Następnie uruchom następujące polecenie:

dotnet build -f net8.0-maccatalyst -c Release

Publikowanie kompilacji, znaków i pakietów aplikacji, a następnie kopiuje .pkg do folderu bin/Release/net8.0-maccatalyst/publish/ .

Rozpowszechnianie aplikacji na potrzeby testowania

.pkg można dystrybuować do użytkowników na zarejestrowanych urządzeniach, gdzie można je uruchomić, klikając dwukrotnie plik .pkg, aby zainstalować aplikację.

Aby uzyskać informacje na temat bezpiecznego otwierania aplikacji na komputerze Mac, zobacz Bezpieczne otwieranie aplikacji na komputerze Mac na support.apple.com.

Zobacz też

• Rozpowszechnianie aplikacji na zarejestrowanych urządzeniach na developer.apple.com
• Przygotowywanie aplikacji do dystrybucji w developer.apple.com
• Środowisko uruchomieniowe ze wzmocnionym zabezpieczeniami w developer.apple.com