Sdílet prostřednictvím


Publikování aplikace Mac Catalyst pro ad hoc distribuci

Při distribuci aplikací Mac Catalyst mimo Mac App Store se můžete také rozhodnout distribuovat aplikaci omezenému počtu uživatelů na registrovaných zařízeních. To se označuje jako ad hoc distribuce a primárně se používá pro testování aplikací v rámci skupiny lidí. Je ale omezený na 100 zařízení za rok členství a zařízení se musí přidat do vašeho účtu Apple Developer. Tento distribuční přístup můžou používat členové programu Apple Developer Program a Program Apple Developer Enterprise.

Distribuce aplikace Mac Catalyst vyžaduje, aby byla aplikace zřízena pomocí zřizovacího profilu. Zřizovací profily jsou soubory, které obsahují informace o podepisování kódu, a také identitu aplikace a její zamýšlený distribuční mechanismus.

Pokud chcete distribuovat multiplatformní uživatelské rozhraní aplikace .NET MAUI (.NET MAUI) Mac Catalyst mimo Mac App Store s ad hoc distribucí, budete muset vytvořit vývojový zřizovací profil specifický pro něj. Tento profil umožňuje digitálně podepsat aplikaci pro vydání, aby ji bylo možné nainstalovat na Počítače Mac. Profil zřizování ad hoc pro vývoj obsahuje ID aplikace, vývojový certifikát a seznam zařízení, která můžou aplikaci nainstalovat. Pokud ho ještě nemáte, budete muset vytvořit vývojový certifikát pro identifikaci sebe nebo vaší organizace.

Proces zřizování aplikace .NET MAUI Mac Catalyst pro ad hoc distribuci je následující:

  1. Vytvořte žádost o podepsání certifikátu. Další informace najdete v tématu Vytvoření žádosti o podepsání certifikátu.
  2. Vytvořte vývojový certifikát. Další informace najdete v tématu Vytvoření vývojového certifikátu.
  3. Vytvořte ID aplikace. Další informace najdete v tématu Vytvoření ID aplikace.
  4. Přidejte zařízení do svého vývojářského účtu Apple. Další informace najdete v tématu Přidání zařízení.
  5. Vytvoření zřizovacího profilu Další informace najdete v tématu Vytvoření zřizovacího profilu.
  6. Stáhněte si zřizovací profil. Další informace najdete v tématu Stažení zřizovacího profilu v Xcode.

Důležité

Tento článek ukazuje zřizování ad hoc distribuce pomocí vývojářského účtu Apple, který je součástí programu Apple Developer Program. Můžete ho také použít pro vývojářský účet Apple, který je součástí programu Apple Developer Enterprise Program, protože požadované kroky jsou z velké části identické.

Po dokončení zřizování byste měli aplikaci připravit na publikování a pak ji publikovat pomocí následujícího procesu:

  1. Volitelně můžete do aplikace přidat nároky. Další informace najdete v tématu Přidání nároků.
  2. Aktualizujte soubor Info.plist aplikace. Další informace naleznete v tématu Aktualizace Info.plist.
  3. Publikujte aplikaci pomocí příkazového řádku. Další informace najdete v tématu Publikování pomocí příkazového řádku.

Vytvoření žádosti o podepsání certifikátu

Před vytvořením distribučního certifikátu budete nejprve muset vytvořit žádost o podepsání certifikátu (CSR) v Klíčence accessu na Macu:

  1. Na macu spusťte Keychain Access.

  2. V okně Přístup ke klíčence vyberte položku nabídky Keychain Access > Certificate Assistant > požádat o certifikát od certifikační autority... .

  3. V dialogovém okně Pomocníka s certifikáty zadejte e-mailovou adresu do pole E-mailová adresa uživatele.

  4. V dialogovém okně Pomocníka s certifikáty zadejte název klíče do pole Běžný název .

  5. V dialogovém okně Pomocníka s certifikáty nechejte pole E-mailová adresa certifikační autority prázdné.

  6. V dialogovém okně Pomocníka s certifikáty zvolte přepínač Uložit na disk a vyberte Pokračovat:

    Dialogové okno Pomocníka s certifikáty

  7. Uložte žádost o podepsání certifikátu do známého umístění.

  8. V dialogovém okně Pomocníka s certifikáty vyberte tlačítko Hotovo .

  9. Zavřete přístup ke klíčence.

Vytvoření vývojového certifikátu

CSR umožňuje vygenerovat vývojový certifikát, který potvrzuje vaši identitu. Vývojový certifikát se musí vytvořit pomocí Apple ID pro váš vývojářský účet Apple:

  1. Ve webovém prohlížeči se přihlaste ke svému vývojářskému účtu Apple.

  2. Ve svém vývojářském účtu Apple vyberte kartu Certifikáty, ID a Profily .

  3. Na stránce Certifikáty, Identifikátory a profily vyberte + tlačítko pro vytvoření nového certifikátu.

  4. Na stránce Vytvořit nový certifikát vyberte před výběrem tlačítka Pokračovat přepínač Vývoj Apple:

    Vytvořte vývojový certifikát Apple.

  5. Na stránce Vytvořit nový certifikát vyberte Zvolit soubor:

    Nahrajte žádost o podepsání certifikátu.

  6. V dialogovém okně Zvolit soubory k nahrání vyberte soubor žádosti o certifikát, který jste předtím vytvořili (soubor s příponou .certSigningRequest souboru) a pak vyberte Nahrát.

  7. Na stránce Vytvořit nový certifikát vyberte tlačítko Pokračovat:

    Pokračujte vygenerování distribučního certifikátu.

  8. Na stránce Stáhnout certifikát vyberte tlačítko Stáhnout:

    Stáhněte si distribuční certifikát.

    Soubor certifikátu (soubor s příponou .cer ) se stáhne do zvoleného umístění.

  9. Na počítači Mac poklikejte na stažený soubor certifikátu a nainstalujte certifikát do klíčenky. Certifikát se zobrazí v kategorii Moje certifikáty v přístupu ke klíčence a začíná vývojem apple:

    Přístup ke klíčence zobrazující vývojový certifikát

    Poznámka:

    Poznamenejte si úplný název certifikátu v klíčence Accessu. Při podepisování aplikace se bude vyžadovat.

Vytvoření vývojového profilu

Ad hoc vývojový zřizovací profil umožňuje digitálně podepsat aplikaci .NET MAUI Mac Catalyst, aby ji bylo možné nainstalovat na konkrétní počítače Mac. Profil zřizování ad hoc pro vývoj obsahuje ID aplikace, vývojový certifikát a seznam zařízení, která můžou aplikaci nainstalovat.

Vytvoření ID aplikace

K identifikaci aplikace, kterou distribuujete, se vyžaduje ID aplikace. ID aplikace je podobné řetězci reverzního DNS, který jednoznačně identifikuje aplikaci a měl by být shodný s identifikátorem sady pro vaši aplikaci. K testování můžete použít stejné ID aplikace, které jste použili při nasazování aplikace do zařízení.

Existují dva typy ID aplikace:

  • Zástupný znak. ID aplikace se zástupným znakem umožňuje použít jedno ID aplikace ke shodě s více aplikacemi a obvykle má tvar com.domainname.*. ID aplikace se zástupným znakem se dá použít k distribuci více aplikací a mělo by se použít pro aplikace, které nepovolují funkce specifické pro aplikace.
  • Explicitní. Explicitní ID aplikace je jedinečné pro jednu aplikaci a obvykle má tvar com.domainname.myid. Explicitní ID aplikace umožňuje distribuci jedné aplikace s odpovídajícím identifikátorem sady. Explicitní ID aplikací se obvykle používají pro aplikace, které umožňují funkce specifické pro aplikace, jako je Apple Pay nebo Game Center. Další informace o možnostech najdete v tématu Možnosti.

Vytvoření nového ID aplikace:

  1. Ve svém vývojářském účtu Apple přejděte na Certifikáty, ID a profily.

  2. Na stránce Certifikáty, Identifikátory a Profily vyberte kartu Identifikátory.

  3. Na stránce Identifikátory vyberte + tlačítko a vytvořte nové ID aplikace.

  4. Na stránce Zaregistrovat nový identifikátor vyberte přepínač ID aplikací před výběrem tlačítka Pokračovat:

    Vytvořte ID aplikace.

  5. Na stránce Zaregistrovat nový identifikátor vyberte před výběrem tlačítka Pokračovat aplikaci:

    Zaregistrujte ID aplikace.

  6. Na stránce Registrace ID aplikace zadejte popis a vyberte přepínač Explicit nebo Wildcard Bundle ID. Pak zadejte ID sady prostředků aplikace v obráceném formátu DS:

    Zadejte identifikátor sady prostředků pro aplikaci.

    Důležité

    ID sady, které zadáte, musí odpovídat identifikátoru sady v souboru Info.plist v projektu aplikace.

    Identifikátor sady pro aplikaci .NET MAUI je uložen v souboru projektu jako vlastnost ID aplikace. V sadě Visual Studio klikněte v Průzkumník řešení pravým tlačítkem myši na projekt aplikace .NET MAUI a vyberte Vlastnosti. Pak přejděte na kartu MauI Sdílené > obecné . Pole ID aplikace obsahuje identifikátor sady.

    Při aktualizaci hodnoty pole ID aplikace se automaticky aktualizuje hodnota identifikátoru sady v souboru Info.plist.

  7. Na stránce Zaregistrovat ID aplikace vyberte všechny možnosti, které aplikace používá. Na této stránce i v souboru Entitlements.plist v projektu aplikace musí být nakonfigurované všechny možnosti. Další informace naleznete v tématu Schopnosti a nároky.

  8. Na stránce Zaregistrovat ID aplikace vyberte tlačítko Pokračovat.

  9. Na stránce Potvrdit ID aplikace vyberte tlačítko Zaregistrovat.

Přidání zařízení

Při vytváření zřizovacího profilu pro ad hoc distribuci musí profil obsahovat, která zařízení můžou aplikaci spouštět. Před výběrem zařízení, která se mají přidat do zřizovacího profilu, musíte nejdřív přidat zařízení do svého vývojářského účtu Apple. Toho lze dosáhnout pomocí následujících kroků:

  1. Vyberte položku nabídky Apple > About this Mac (O tomto Macu).

  2. Na kartě Přehled vyberte tlačítko System Report... (Sestava systému).

  3. V systémové sestavě vyberte rozbalovač hardwaru a zobrazte přehled hardwaru. Sestava zobrazí identifikátor UUID (Universally Unique Identifier) jako identifikátor UUID hardwaru v systému macOS 10.15 a starší nebo zřizování UDID v systému macOS 11.0 a novější.

  4. Vyberte hodnotu UUID hardwaru nebo zřizování identifikátoru UDID a zkopírujte ji do schránky.

  5. Ve webovém prohlížeči přejděte do části Zařízení vašeho vývojářského účtu Apple a klikněte na + tlačítko.

  6. Na stránce Zaregistrovat nové zařízení nastavte platformu na macOS a zadejte název nového zařízení. Potom vložte identifikátor ze schránky do pole ID zařízení (UUID) a klikněte na tlačítko Pokračovat :

    Zaregistrujte zařízení tak, že ho pojmete a zadáte jeho jedinečný identifikátor zařízení.

  7. Na stránce Zaregistrovat nové zařízení zkontrolujte informace a klikněte na tlačítko Zaregistrovat.

Opakujte výše uvedené kroky pro všechny počítače Mac, které chcete nasadit aplikaci .NET MAUI Mac Catalyst pro použití ad hoc distribuce.

Vytvoření zřizovacího profilu

Po vytvoření ID aplikace byste měli vytvořit profil zřizování pro vývoj. Tento profil umožňuje digitálně podepsat aplikaci, aby ji bylo možné nainstalovat na konkrétní počítače Mac.

Vytvoření zřizovacího profilu pro ad hoc distribuci:

  1. Na stránce Certifikáty, Identifikátory a profily vašeho účtu apple pro vývojáře vyberte kartu Profily .

  2. Na kartě Profily kliknutím na + tlačítko vytvořte nový profil.

  3. Na stránce Zaregistrovat nový profil zřizování vyberte přepínač vývoj aplikací pro macOS před kliknutím na tlačítko Pokračovat:

    Zaregistrujte zřizovací profil pro ad hoc distribuci.

  4. Na stránce Vygenerovat zřizovací profil vyberte přepínač Mac Catalyst. Potom v rozevíracím seznamu ID aplikace vyberte ID aplikace, které jste vytvořili dříve, než kliknete na tlačítko Pokračovat :

    Vyberte ID vaší aplikace.

  5. Na stránce Vygenerovat zřizovací profil zaškrtněte políčko odpovídající vašemu vývojovému certifikátu před kliknutím na tlačítko Pokračovat:

    Vyberte svůj vývojový certifikát.

  6. Na stránce Vygenerovat zřizovací profil vyberte zařízení, na která se aplikace nainstaluje, a potom klikněte na tlačítko Pokračovat.

    Snímek obrazovky s přidáním zařízení do zřizovacího profilu

  7. Na stránce Vygenerovat zřizovací profil zadejte název zřizovacího profilu před kliknutím na tlačítko Generovat :

    Vygenerujte profil zřizování.

    Poznámka:

    Poznamenejte si název zřizovacího profilu, protože se bude při podepisování aplikace vyžadovat.

  8. Na stránce Vygenerovat zřizovací profil můžete volitelně kliknutím na tlačítko Stáhnout stáhnout zřizovací profil.

    Poznámka:

    Teď není nutné stáhnout zřizovací profil. Místo toho to uděláte v Xcode.

Stažení zřizovacího profilu v Xcode

Po vytvoření zřizovacího profilu v účtu Apple Developer si ho Xcode může stáhnout, aby byl k dispozici pro podepisování vaší aplikace:

  1. Na macu spusťte Xcode.

  2. V Xcode vyberte položku nabídky Xcode Preferences... (Předvolby Xcode>).

  3. V dialogovém okně Předvolby vyberte kartu Účty .

  4. Na kartě Účty klikněte na + tlačítko a přidejte svůj vývojářský účet Apple do Xcode:

    Dialogové okno Účty Xcode v předvolbách

  5. V místní nabídce typu účtu vyberte Apple ID a potom klikněte na tlačítko Pokračovat :

    Xcode vyberte typ účtu, který chcete přidat.

  6. V místní nabídce pro přihlášení zadejte Apple ID a klikněte na tlačítko Další .

  7. V místní nabídce pro přihlášení zadejte heslo Apple ID a klikněte na tlačítko Další :

    Přihlášení k účtu Xcode Apple

  8. Na kartě Účty klikněte na tlačítko Spravovat certifikáty... a ujistěte se, že byl váš distribuční certifikát stažen.

  9. Na kartě Účty klikněte na tlačítko Stáhnout ruční profily a stáhněte si zřizovací profily:

    Podrobnosti účtu Xcode Apple Developer Program.

  10. Počkejte, až se stahování dokončí, a pak Xcode zavřete.

Přidání nároků

Sandbox aplikací společnosti Apple omezuje přístup k systémovým prostředkům a uživatelským datům v aplikacích pro Mac, aby obsahoval poškození, pokud dojde k ohrožení zabezpečení aplikace. Musí být povolená pro aplikace Mac Catalyst, které jsou distribuovány prostřednictvím Mac App Storu, a volitelně je možné povolit pro aplikace Mac Catalyst, které jsou distribuovány mimo Mac App Store.

Toho lze dosáhnout přidáním souboru Entitlements.plist do složky Platforms/MacCatalyst projektu aplikace .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>

Oprávnění sandboxu aplikace je definováno pomocí com.apple.security.app-sandbox klíče typu boolean. Informace o sandboxu aplikací najdete v tématu Ochrana uživatelských dat pomocí Sandboxu aplikací na developer.apple.com. Informace o oprávnění sandboxu aplikace najdete v tématu Oprávnění sandboxu aplikace.

Pokud vaše aplikace otevře odchozí síťová připojení, budete muset do souboru Entitlements.plist přidat com.apple.security.network.client také klíč typuboolean:

<?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>

Informace o oprávnění odchozích síťových připojení najdete na webu com.apple.security.network.client na developer.apple.com.

Aktualizace souboru Info.plist

Před distribucí aplikace byste měli aktualizovat její soubor Info.plist dalšími informacemi.

Poznámka:

I když není nutné aktualizovat soubor Info.plist vaší aplikace při jeho distribuci pro testování, tyto aktualizace se budou vyžadovat při distribuci konečné otestované verze vaší aplikace. Proto je osvědčeným postupem provést tyto aktualizace.

Určení idiomu uživatelského rozhraní

Aplikace Mac Catalyst může běžet v iPadu nebo Mac uživatelského rozhraní idiom:

  • IDiom uživatelského rozhraní iPadu říká macOS, aby škálovat uživatelské rozhraní aplikace tak, aby odpovídalo prostředí zobrazení Mac při zachování vzhledu podobného iPadu.
  • Idiom uživatelského rozhraní Systému Mac nenasahuje měřítko uživatelského rozhraní aplikace tak, aby odpovídalo prostředí pro zobrazení macu. Některé ovládací prvky mění jejich velikost a vzhled a interakce s nimi je stejná jako interakce s ovládacími AppKit prvky.

Ve výchozím nastavení aplikace .NET MAUI Mac Catalyst používají idiom uživatelského rozhraní iPad. Pokud se jedná o požadované chování, ujistěte se, že soubor Info.plist aplikace jako hodnotu UIDeviceFamily klíče určuje jenom 2:

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

Pokud chcete přijmout idiom uživatelského rozhraní Mac, aktualizujte soubor Info.plist aplikace tak, aby jako hodnotu UIDeviceFamily klíče zadal 6:

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

Další informace o idiomy uživatelského rozhraní Mac Catalyst naleznete v tématu Určení idiom uživatelského rozhraní pro aplikaci Mac Catalyst.

Nastavení výchozího jazyka a oblasti aplikace

CFBundleDevelopmentRegion Nastavte klíč v souboru Info.plist vaší aplikace na string hodnotu, která představuje nativní oblast vývoje lokalizace:

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

Hodnota klíče by měla být návrhátorem jazyka s volitelným designátorem oblasti. Další informace naleznete v tématu CFBundleDevelopmentRegion na developer.apple.com.

NSHumanReadableCopyright Nastavte klíč v souboru Info.plist vaší aplikace na string hodnotu, která představuje oznámení o autorských právech pro člověka čitelné pro vaši aplikaci:

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

Další informace naleznete v tématu NS HumanReadableCopyright na developer.apple.com.

Deklarace použití šifrování vaší aplikace

Pokud vaše aplikace používá šifrování a plánujete ji distribuovat mimo USA nebo Kanadu, podléhá požadavkům na dodržování předpisů pro export v USA. Informace o tom, jak aplikace používá šifrování, můžete zadat v souboru Info.plist .

Toho dosáhnete tak, že do souboru Info.plist vaší aplikace přidáte ITSAppUsesNonExemptEncryption klíč s boolean hodnotou, která označuje, jestli vaše aplikace používá šifrování:

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

Další informace naleznete v tématu Dodržování předpisů pro export šifrování v developer.apple.com.

Publikování pomocí příkazového řádku

Pokud chcete publikovat aplikaci Mac Catalyst z příkazového řádku na Macu, otevřete terminál a přejděte do složky projektu aplikace .NET MAUI. dotnet publish Spusťte příkaz a zadejte následující parametry:

Parametr Hodnota
-f nebo --framework Cílová architektura, která je net8.0-maccatalyst.
-c nebo --configuration Konfigurace sestavení, což je Release.
-p:MtouchLink Režim propojení projektu, který může být None, SdkOnlynebo Full.
-p:CreatePackage Nastaví se tak true , aby se pro aplikaci na konci sestavení vytvořil balíček (.pkg).
-p:EnableCodeSigning Nastaví se tak true , aby bylo povoleno podepisování kódu.
-p:CodesignKey Název podpisového klíče kódu. Nastavte na název distribučního certifikátu, jak je zobrazeno v Accessu ke klíčence.
-p:CodesignProvision Profil zřizování, který se má použít při podepisování sady aplikací.
-p:CodesignEntitlements Cesta k souboru nároků, který určuje nároky, které aplikace vyžaduje. Nastavte na Platforms\MacCatalyst\Entitlements.plist.
-p:RuntimeIdentifier Identifikátor modulu runtime (RID) projektu. Vydané buildy aplikací .NET MAUI Mac Catalyst se standardně používají maccatalyst-x64 a maccatalyst-arm64 jako identifikátory modulu runtime podporují univerzální aplikace. Pokud chcete podporovat pouze jednu architekturu, zadejte maccatalyst-x64 nebo maccatalyst-arm64.
-p:UseHardenedRuntime Nastavte na true povolení posíleného modulu runtime, který je nutný pro aplikace Mac Catalyst, které jsou distribuovány mimo Mac App Store.

Upozorňující

Pokus o publikování řešení .NET MAUI způsobí dotnet publish , že se příkaz pokusí publikovat každý projekt v řešení jednotlivě, což může způsobit problémy při přidání dalších typů projektů do řešení. dotnet publish Proto by měl být příkaz vymezený na váš projekt aplikace .NET MAUI.

Další parametry sestavení je možné zadat na příkazovém řádku, pokud nejsou zadané v <PropertyGroup> souboru projektu. V následující tabulce jsou uvedeny některé běžné parametry:

Parametr Hodnota
-p:ApplicationTitle Jméno viditelné uživatelem aplikace
-p:ApplicationId Jedinečný identifikátor aplikace, například com.companyname.mymauiapp.
-p:ApplicationVersion Verze sestavení, která identifikuje iteraci aplikace.
-p:ApplicationDisplayVersion Číslo verze aplikace
-p:RuntimeIdentifier Identifikátor modulu runtime (RID) projektu. Vydané buildy aplikací .NET MAUI Mac Catalyst se standardně používají maccatalyst-x64 a maccatalyst-arm64 jako identifikátory modulu runtime podporují univerzální aplikace. Pokud chcete podporovat pouze jednu architekturu, zadejte maccatalyst-x64 nebo maccatalyst-arm64.

Úplný seznam vlastností sestavení najdete v tématu Vlastnosti souboru projektu.

Důležité

Hodnoty pro všechny tyto parametry nemusí být zadané na příkazovém řádku. Dají se také zadat v souboru projektu. Pokud je parametr zadaný na příkazovém řádku a v souboru projektu, má přednost parametr příkazového řádku. Další informace o poskytování vlastností sestavení v souboru projektu naleznete v tématu Definování vlastností sestavení v souboru projektu.

Pomocí následujícího příkazu můžete například sestavit a podepsat .pkg na Macu pro ad hoc distribuci uživatelům na registrovaných zařízeních:

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

Poznámka:

V .NET 8 se příkaz dotnet publish ve výchozím nastavení nastaví na Release konfiguraci. Proto je možné konfiguraci sestavení z příkazového řádku vynechat.

Publikování sestavení, podepíše a zabalí aplikaci a potom zkopíruje .pkg do složky bin/Release/net8.0-maccatalyst/publish/ . Pokud aplikaci publikujete jenom pomocí jedné architektury, publikuje se do složky bin/Release/net8.0-maccatalyst/{architecture}/publish/ .

Během procesu podepisování je možná nutné zadat své přihlašovací heslo a povolit codesign spuštění:

Povolte codesign podepsat aplikaci na Macu.

Další informace o dotnet publish příkazu naleznete v tématu dotnet publish.

Definování vlastností sestavení v souboru projektu

Alternativou k určení parametrů sestavení na příkazovém řádku je zadat je v souboru projektu v souboru projektu v souboru <PropertyGroup>. V následující tabulce jsou uvedeny některé společné vlastnosti sestavení:

Vlastnost Hodnota
<ApplicationTitle> Jméno viditelné uživatelem aplikace
<ApplicationId> Jedinečný identifikátor aplikace, například com.companyname.mymauiapp.
<ApplicationVersion> Verze sestavení, která identifikuje iteraci aplikace.
<ApplicationDisplayVersion> Číslo verze aplikace
<CodesignKey> Název podpisového klíče kódu. Nastavte na název distribučního certifikátu, jak je zobrazeno v Accessu ke klíčence.
<CodesignEntitlements> Cesta k souboru nároků, který určuje nároky, které aplikace vyžaduje. Nastavte na Platforms\MacCatalyst\Entitlements.plist.
<CodesignProvision> Profil zřizování, který se má použít při podepisování sady aplikací.
<CreatePackage> Nastaví se tak true , aby se pro aplikaci na konci sestavení vytvořil balíček (.pkg).
<EnableCodeSigning> Nastaví se tak true , aby bylo povoleno podepisování kódu.
<MtouchLink> Režim propojení projektu, který může být None, SdkOnlynebo Full.
<RuntimeIdentifier> Identifikátor modulu runtime (RID) projektu. Vydané buildy aplikací .NET MAUI Mac Catalyst se standardně používají maccatalyst-x64 a maccatalyst-arm64 jako identifikátory modulu runtime podporují univerzální aplikace. Pokud chcete podporovat pouze jednu architekturu, zadejte maccatalyst-x64 nebo maccatalyst-arm64.
<UseHardenedRuntime> Nastavte na true povolení posíleného modulu runtime, který je nutný pro aplikace Mac Catalyst, které jsou distribuovány mimo Mac App Store.

Úplný seznam vlastností sestavení najdete v tématu Vlastnosti souboru projektu.

Důležité

Hodnoty těchto vlastností sestavení nemusí být v souboru projektu zadané. Dají se také poskytnout na příkazovém řádku při publikování aplikace. To umožňuje vynechat konkrétní hodnoty ze souboru projektu.

Následující příklad ukazuje typickou skupinu vlastností pro sestavení a podepsání aplikace Mac Catalyst pro ad hoc distribuci uživatelům na registrovaných zařízeních:

<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>

Tento příklad <PropertyGroup> přidá kontrolu podmínky, která brání zpracování nastavení, pokud kontrola podmínky neprojde. Kontrola podmínky hledá dvě položky:

  1. Konfigurace sestavení je nastavena na Releasehodnotu .
  2. Cílová architektura je nastavena na něco, co obsahuje text net8.0-maccatalyst.
  3. Platforma je nastavena na AnyCPU.

Pokud některá z těchto podmínek selže, nastavení se nezpracuje. Důležitější je, že <CodesignKey> nastavení a <CodesignProvision> nastavení nejsou nastavené, aby aplikace nebyla podepsána.

Po přidání výše uvedené skupiny vlastností je možné aplikaci publikovat z příkazového řádku na Macu tak, že otevřete terminál a přejdete do složky projektu aplikace .NET MAUI. Potom spusťte následující příkaz:

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

Publikování sestavení, podepíše a zabalí aplikaci a potom zkopíruje .pkg do složky bin/Release/net8.0-maccatalyst/publish/ .

Distribuce aplikace pro testování

.pkg je možné distribuovat uživatelům na registrovaných zařízeních, kde ho můžete spustit poklikáním na soubor .pkg a aplikaci nainstalovat.

Informace o bezpečném otevírání aplikací na Macu najdete v tématu Bezpečné otevření aplikací na macu na support.apple.com.

Viz také