Nároky na iOS

V iOSu běží aplikace .NET s více platformami (.NET MAUI) v sandboxu, které poskytují sadu pravidel, která omezují přístup mezi aplikací a systémovými prostředky nebo uživatelskými daty. Nároky se používají k vyžádání rozšíření sandboxu, aby vaše aplikace poskytovala další možnosti, jako je integrace se Siri. Všechna oprávnění používaná vaší aplikací musí být zadána v souboru Entitlements.plist aplikace. Další informace o oprávněních najdete v tématu Nároky na developer.apple.com.

Kromě zadávání nároků se k podepsání aplikace používá soubor Entitlements.plist . Při podepisování kódu se soubor nároků zkombinuje s informacemi z vašeho vývojářského účtu Apple a dalšími informacemi o projektu, aby se na vaši aplikaci použila konečná sada nároků.

Nároky úzce souvisejí s konceptem schopností. Obě požadují rozšíření sandboxu, ve kterém se vaše aplikace spouští, aby jí poskytla další možnosti. Nároky se obvykle přidávají při vývoji aplikace, zatímco funkce se obvykle přidávají při podepisování kódu pro distribuci. Pokud je ale povolené automatické zřizování, přidání určitých oprávnění do vaší aplikace také aktualizuje možnosti vaší aplikace v jejím zřizovacím profilu. Další informace najdete v tématu Přidání funkcí pomocí sady Visual Studio.

Důležité

Soubor Entitlements.plist není propojený s účtem Apple Developer. Proto při vytváření zřizovacího profilu pro vaši aplikaci byste měli zajistit, aby všechny nároky používané vaší aplikací byly také specifikovány jako možnosti v jeho zřizovacím profilu. Další informace najdete v tématu Možnosti.

Přidání souboru Entitlements.plist

Pokud chcete do projektu aplikace .NET MAUI přidat nový soubor nároků, přidejte do složky Platforms\iOS projektu aplikace nový soubor XML s názvem Entitlements.plist. Pak do souboru přidejte následující kód XML:

<?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>
</dict>
</plist>

Nastavení nároků

V sadě Visual Studio lze nároky nakonfigurovat tak, že poklikáním na soubor Entitlements.plist ho otevřete v editoru nároků.

Visual Studio

1. V Průzkumník řešení poklikejte na soubor Entitlements.plist ze složky Platformy > pro iOS projektu aplikace .NET MAUI a otevřete ho v editoru nároků.

2. V editoru nároků vyberte a nakonfigurujte všechna oprávnění vyžadovaná vaší aplikací:

   

3. Uložte změny v souboru Entitlements.plist a přidejte do souboru páry klíč/hodnota nároku.

Visual Studio pro Mac

Poznámka:

Visual Studio pro Mac plánujeme do 31. srpna 2024 v souladu s Moderní zásady životního cyklu Od Microsoftu Visual Studio pro Mac 17.6 bude nadále podporován až do 31. srpna 2024 s servisními aktualizacemi problémů se zabezpečením a aktualizovanými platformami od Společnosti Apple. Další informace, včetně alternativních možností vývoje na Macu, najdete v tématu Co se děje s Visual Studio pro Mac?.

1. V okně řešení poklikejte na soubor Entitlements.plist ze složky Platformy > pro iOS projektu aplikace .NET MAUI a otevřete ho v editoru nároků. Potom přejděte ze zobrazení Zdroj na zobrazení Nároky :

   

2. V editoru nároků vyberte a nakonfigurujte všechna oprávnění požadovaná pro vaši aplikaci:

   

3. Uložte změny v souboru Entitlements.plist a přidejte do souboru páry klíč/hodnota nároku.

Pro určité nároky může být také nutné nastavit klíče ochrany osobních údajů v souboru Info.plist.

Využívání nároků

Aplikace .NET MAUI pro iOS musí být nakonfigurovaná tak, aby spotřebovala nároky definované v souboru Entitlements.plist .

Visual Studio

1. V Průzkumník řešení klikněte pravým tlačítkem na projekt aplikace .NET MAUI a vyberte Vlastnosti. Pak přejděte na kartu Podepisování sady prostředků iOS>.

2. V nastavení podepisování sady klikněte na tlačítko Procházet... pro pole Vlastní nároky.

3. V dialogovém okně Vlastní nároky přejděte do složky obsahující váš soubor Entitlements.plist, vyberte soubor a klikněte na tlačítko Otevřít.

4. Ve vlastnostech projektu bude pole Vlastní nároky vyplněno souborem nároků:

   

5. Zavřete vlastnosti projektu.

Poznámka:

Visual Studio nastaví pole vlastních nároků pro sestavení ladění i vydané verze.

Visual Studio pro Mac

Poznámka:

Visual Studio pro Mac plánujeme do 31. srpna 2024 v souladu s Moderní zásady životního cyklu Od Microsoftu Visual Studio pro Mac 17.6 bude nadále podporován až do 31. srpna 2024 s servisními aktualizacemi problémů se zabezpečením a aktualizovanými platformami od Společnosti Apple. Další informace, včetně alternativních možností vývoje na Macu, najdete v tématu Co se děje s Visual Studio pro Mac?.

1. V okně řešení klikněte pravým tlačítkem na projekt aplikace .NET MAUI a vyberte Vlastnosti.

2. V okně Vlastnosti projektu vyberte kartu Sestavení > sady prostředků pro iOS > a klikněte na tlačítko ... vedle pole Vlastní nároky:

   

3. V dialogovém okně přejděte do složky obsahující váš soubor Entitlements.plist , vyberte soubor a klikněte na tlačítko Otevřít .

4. V okně Vlastnosti projektu bude pole Vlastní nároky vyplněno souborem nároků:

   

5. V okně Vlastnosti projektu zavřete okno kliknutím na tlačítko OK .

Důležité

Pro každou konfiguraci sestavení pro vaši aplikaci musí být nastaveno samostatné pole oprávnění.

Pokud je povolené automatické zřizování, přidá se do zřizovacího profilu vaší aplikace jako možnosti také podmnožina nároků. Další informace najdete v tématu Přidání funkcí pomocí sady Visual Studio.

Referenční informace ke klíči

Páry klíč/hodnota nároku jsou uvedené níže pro referenci. V sadě Visual Studio je možné je přidat úpravou souboru Entitlements.plist jako souboru XML. V Visual Studio pro Mac je možné je přidat pomocí zobrazení Zdroj editoru nároků.

Přístup k informacím o Wi-Fi

Tento přístup k informacím o Wi-Fi umožňuje vaší aplikaci získat informace o aktuálně připojené síti Wi-Fi.

Nárok je definován pomocí com.apple.developer.networking.wifi-info klíče typu Boolean:

<key>com.apple.developer.networking.wifi-info</key>
<true/>

Další informace najdete v tématu Přístup k oprávnění k informacím o wi-fi na developer.apple.com.

Test aplikace

Pomocí oprávnění App Attest můžete v zařízení vygenerovat speciální kryptografický klíč a použít ho k ověření integrity aplikace před tím, než server poskytne přístup k citlivým datům.

Nárok je definován pomocí com.apple.developer.devicecheck.appattest-environment klíče typu String:

<key>com.apple.developer.devicecheck.appattest-environment</key>
<string>development</string>

Další informace najdete v tématu App Attest Environment na developer.apple.com.

Skupiny aplikací

Nárok na skupiny aplikací umožňuje aplikaci přistupovat ke kontejnerům skupin sdíleným mezi více souvisejícími aplikacemi a také provádět komunikaci mezi procesy mezi aplikacemi.

Nárok je definován pomocí com.apple.security.application-groups klíče typu ArrayString:

<key>com.apple.security.application-groups</key>
<array>
  <string>group.MyAppGroups</string>
</array>

Další informace najdete v tématu Nárok na skupiny aplikací na developer.apple.com.

Apple Pay

Nárok Apple Pay umožňuje uživatelům snadno a bezpečně platit za fyzické dobré služby a služby, jako jsou potraviny, oblečení, lístky a rezervace, pomocí platebních údajů uložených na svém zařízení.

Nárok je definován pomocí com.apple.developer.in-app-payments klíče typu ArrayString:

<key>com.apple.developer.in-app-payments</key>
<array>
  <string>merchant.your.merchantid</string>
</array>

Další informace najdete v tématu Nárok na ID obchodníků na developer.apple.com.

Přidružené domény

Přidružený nárok na domény umožňuje, aby vaše aplikace byla přidružená ke konkrétním doménám pro konkrétní služby, jako je přístup k Safari, uložená hesla a pokračování aktivity.

Nárok je definován pomocí com.apple.developer.associated-domains klíče typu ArrayString:

<key>com.apple.developer.associated-domains</key>
<array>
  <string>webcredentials:example.com</string>
</array>

Další informace najdete v tématu Oprávnění k přidruženým doménám na developer.apple.com.

Poskytovatel přihlašovacích údajů automatického vyplňování

Oprávnění zprostředkovatele přihlašovacích údajů automatického vyplňování umožňuje aplikaci s uživatelským oprávněním zadat do aplikace a Safari uživatelská jména a hesla pro automatické vyplňování.

Nárok je definován pomocí com.apple.developer.authentication-services.autofill-credential-provider klíče typu Boolean:

<key>com.apple.developer.authentication-services.autofill-credential-provider</key>
<true/>

Další informace najdete v tématu Oprávnění zprostředkovatele přihlašovacích údajů automatického vyplňování na developer.apple.com.

ClassKit

Nárok ClassKit umožňuje aplikaci soukromě a bezpečně sdílet pokrok studentů s učiteli v přiřazených aktivitách, jako je čtení kapitoly v knize nebo kvíz, v prostředích spravovaných školou.

Nárok je definován pomocí com.apple.developer.ClassKit-environment klíče typu String:

<key>com.apple.developer.ClassKit-environment</key>
<string>development</string>

Další informace najdete v tématu Nárok prostředí ClassKit na developer.apple.com.

Komunikuje s ovladači

Komunikace s nárokem ovladačů umožňuje komunikaci mezi ovladači aplikace a ovladači DriverKit.

Nárok je definován pomocí com.apple.developer.driverkit.communicates-with-drivers klíče typu Boolean:

<key>com.apple.developer.driverkit.communicates-with-drivers</key>
<true/>

Další informace naleznete v tématu Komunikace s ovladači na developer.apple.com.

Oznámení o komunikaci

Nárok na oznámení o komunikaci umožňuje aplikaci odesílat oznámení o komunikaci od osoby nebo více osob.

Nárok je definován pomocí com.apple.developer.usernotifications.communication klíče typu Boolean:

<key>com.apple.developer.usernotifications.communication</key>
<true/>

Další informace najdete v tématu Žádost o nárok na službu oznámení na developer.apple.com.

Ochrana dat

Nárok na ochranu dat umožňuje vaší aplikaci používat integrované šifrování na podporovaných zařízeních. Když zadáte soubor jako chráněný, systém uloží soubor v šifrovaném formátu.

Nárok je definován pomocí com.apple.developer.default-data-protection klíče typu String:

<key>com.apple.developer.default-data-protection</key>
<string>NSFileProtectionComplete</string>

Další informace najdete v tématu Nárok na ochranu dat na developer.apple.com.

Rozšířené virtuální adresování

Rozšířený nárok na virtuální adresování umožňuje v aplikaci používat více adresního prostoru.

Nárok je definován pomocí com.apple.developer.kernel.extended-virtual-addressing klíče typu Boolean:

<key>com.apple.developer.kernel.extended-virtual-addressing</key>
<true/>

Další informace najdete v tématu Rozšířený nárok na virtuální adresování na developer.apple.com.

Ovládací prvky rodiny

Nárok na řízení rodiny umožňuje ve vaší aplikaci rodičovskou kontrolu a uděluje přístup k architekturám Spravovaných Nastavení a Aktivit zařízení v rozhraní API ScreenTime. Použití rodinného řízení vyžaduje pro registraci uživatele sdílení rodiny. Zabrání odebrání aplikace a povolí filtry obsahu na zařízení z rozšíření sítě.

Nárok je definován pomocí com.apple.developer.family-controls klíče typu Boolean:

<key>com.apple.developer.family-controls</key>
<true/>

Další informace najdete v tématu Nárok na řízení rodiny na developer.apple.com.

Režim testování FileProvider

Nárok na režim testování FileProvider umožňuje testovací režim, který poskytuje rozšíření zprostředkovatele souborů větší kontrolu nad chováním systému během testování.

Nárok je definován pomocí com.apple.developer.fileprovider.testing-mode klíče typu Boolean:

<key>com.apple.developer.fileprovider.testing-mode</key>
<true/>

Další informace naleznete v tématu FileProvider Testing Mode Entitlement on developer.apple.com.

Písma

Nárok na písma umožňuje aplikaci s uživatelským oprávněním instalovat a používat vlastní písma.

Nárok je definován pomocí com.apple.developer.user-fonts klíče typu ArrayString:

<key>com.apple.developer.user-fonts</key>
<array>
  <string>system-installation</string>
</array>

Další informace najdete v tématu Konfigurace vlastních písem v developer.apple.com.

Aktivity skupiny

Nárok na aktivity skupiny umožňuje aplikaci komunikovat se stejnou aplikací na jednom nebo více jiných zařízeních, aby vytvořila skupinovou aktivitu v rámci volání FaceTime. Skupinové aktivity na FaceTime umožňují uživatelům sledovat video společně, poslouchat hudbu nebo provádět jinou synchronní aktivitu.

Nárok je definován pomocí com.apple.developer.group-session klíče typu Boolean:

<key>com.apple.developer.group-session</key>
<true/>

Další informace najdete v tématu Oprávnění k aktivitám skupiny na developer.apple.com.

HealthKit

Oprávnění HealthKitu umožňuje aplikaci přistupovat s uživatelským oprávněním a osobními informacemi o stavu.

Nárok je definován pomocí com.apple.developer.healthkit klíče typu Boolean:

<key>com.apple.developer.healthkit</key>
<true/>

Další informace najdete v tématu Oprávnění HealthKit na developer.apple.com.

HomeKit

Nárok Na HomeKit umožňuje vaší aplikaci pracovat s příslušenstvím HomeKit.

Nárok je definován pomocí com.apple.developer.homekit klíče typu Boolean:

<key>com.apple.developer.homekit</key>
<true/>

Další informace naleznete v tématu HomeKit Entitlement on developer.apple.com.

Konfigurace hotspotu

Nárok na konfiguraci hotspotu umožňuje vaší aplikaci konfigurovat sítě Wi-Fi.

Nárok je definován pomocí com.apple.developer.networking.HotspotConfiguration klíče typu Boolean:

<key>com.apple.developer.networking.HotspotConfiguration</key>
<true/>

Další informace najdete v tématu Nárok na konfiguraci hotspotů na developer.apple.com.

iCloud

Nárok na iCloud umožňuje vaší aplikaci ukládat data do cloudu, aby uživatelé mohli sdílet svá data na více zařízeních.

Nárok se definuje pomocí com.apple.developer.icloud-container-development-container-identifiers klíče, typu ArrayStringa dalších klíčů, které představují identifikátor kontejneru:

<key>com.apple.developer.icloud-container-identifiers</key>
<array>
  <string>iCloud.com.companyname.test</string>
</array>
<key>com.apple.developer.ubiquity-kvstore-identifier</key>
<string>$(AppIdentifierPrefix)$(CFBundleIdentifier)</string>

Zástupné $(AppIdentifierPrefix) symboly a $(CFBundleIdentifier) zástupné symboly budou v době sestavení nahrazeny správnými hodnotami.

Další informace najdete v tématu Nárok na identifikátory kontejnerů iCloudu na developer.apple.com.

Zvýšení limitu paměti

Zvýšený nárok na limit paměti umožňuje vaší aplikaci překročit výchozí limit paměti aplikace na podporovaných zařízeních.

Nárok je definován pomocí com.apple.developer.kernel.increased-memory-limit klíče typu Boolean:

<key>com.apple.developer.kernel.increased-memory-limit</key>
<true/>

Další informace naleznete v tématu Zvýšené nároky na omezení paměti na developer.apple.com.

Zvuk mezi aplikacemi

Nárok na zvuk mezi aplikacemi umožňuje aplikaci odesílat a přijímat zvuk z jiných aplikací s povoleným zvukem mezi aplikacemi.

Nárok je definován pomocí inter-app-audio klíče typu Boolean:

<key>inter-app-audio</key>
<true/>

Další informace najdete v tématu Nárok na zvuk mezi aplikacemi na developer.apple.com.

Důležité

Tento nárok je v iOSu 13 zastaralý a při spouštění aplikací pro iPady v macOS není dostupný.

Keychain

Nárok řetězce klíčů umožňuje sdílení hesel více aplikací, které napsal stejný tým.

Nárok je definován pomocí keychain-access-groups klíče typu ArrayString:

<key>keychain-access-groups</key>
<array>
  <string>$(AppIdentifierPrefix)com.companyname.test</string>
</array>

Další informace najdete v tématu Nárok na přístupové skupiny řetězce klíčů na developer.apple.com.

Spravované domény spravované správou mobilních zařízení (MDM)

Oprávnění k doménám spravovaným správou mobilních aplikací (MDM) umožňuje MDM doplnit přidružené domény, které jsou součástí vaší aplikace, hodnotami, jako jsou názvy serverů, které jsou pro prostředí jedinečné.

Nárok je definován pomocí com.apple.developer.associated-domains.mdm-managed klíče typu Boolean:

<key>com.apple.developer.associated-domains.mdm-managed</key>
<true/>

Více cest

Oprávnění Multipath umožňuje vaší aplikaci používat protokoly s více cestami, jako je například multipath TCP, které bezproblémově předá provoz z jednoho rozhraní do druhého.

Nárok je definován pomocí com.apple.developer.networking.multipath klíče typu Boolean:

<key>com.apple.developer.networking.multipath</key>
<true/>

Další informace najdete v tématu Vícepatový nárok na developer.apple.com.

Čtečka značek komunikace v blízkosti pole

Oprávnění čtečky značek komunikace blízkého pole umožňuje aplikaci číst značky NFC Data Exchanged Format (NDEF) Near Field Communication (NFC).

Nárok je definován pomocí com.apple.developer.nfc.readersession.formats klíče typu ArrayString:

<key>com.apple.developer.nfc.readersession.formats</key>
<array>
  <string>NDEF</string>
  <string>TAG</string>
</array>

Další informace naleznete v tématu Near Field Communication Tag Reader Relace Formátovat nárok na developer.apple.com.

Síťová rozšíření

Nárok na rozšíření sítě umožňuje vytvářet rozšíření aplikací, která rozšiřují a přizpůsobují možnosti sítě vašeho zařízení.

Nárok je definován pomocí com.apple.developer.networking.networkextension klíče typu ArrayString:

<key>com.apple.developer.networking.networkextension</key>
<array>
  <string>content-filter-provider</string>
</array>

Další informace najdete v tématu Nárok na rozšíření sítě na developer.apple.com.

Osobní VPN

Nárok na osobní síť VPN umožňuje vaší aplikaci používat vlastní připojení VPN.

Nárok je definován pomocí com.apple.developer.networking.vpn.api klíče typu ArrayString:

<key>com.apple.developer.networking.vpn.api</key>
<array>
  <string>allow-vpn</string>
</array>

Další informace najdete v tématu Nárok na osobní síť VPN na developer.apple.com.

Nabízená oznámení

Nárok na nabízená oznámení umožňuje vaší aplikaci přijímat nabízená oznámení.

Nárok je definován pomocí aps-environment klíče typu String:

<key>aps-environment</key>
<string>development</string>

Další informace najdete v tématu Nárok na prostředí APS na developer.apple.com.

Nasdílení změn do hovoru

Nárok na nabízenou komunikaci umožňuje vaší aplikaci hlásit kanály Push to Talk do systému, aby mohla zpracovávat přenos a příjem zvuku na pozadí.

Nárok je definován pomocí com.apple.developer.push-to-talk klíče typu Boolean:

<key>com.apple.developer.push-to-talk</key>
<true/>

Další informace naleznete v tématu Push to Talk Entitlement on developer.apple.com.

Sdílí se s vámi

Sdílená s vámi oprávnění umožňuje aplikaci nárokovat odkazy sdílené v konverzacích se zprávami a aby se k nim mohla připojit prostřednictvím architektury Sdílené s vámi.

Nárok je definován pomocí com.apple.developer.shared-with-you klíče typu Boolean:

<key>com.apple.developer.shared-with-you</key>
<true/>

Přihlásit se přes Apple

Přihlášení pomocí oprávnění Apple umožňuje uživatelům ověřovat se pomocí apple ID.

Nárok je definován pomocí com.apple.developer.applesignin klíče typu ArrayString:

<key>com.apple.developer.applesignin</key>
<array>
  <string>Default</string>
</array>

Další informace najdete v tématu Přihlášení pomocí oprávnění Apple na developer.apple.com.

Siri

Nárok Siri umožňuje vaší aplikaci zpracovávat žádosti Siri.

Nárok je definován pomocí com.apple.developer.siri klíče typu Boolean:

<key>com.apple.developer.siri</key>
<true/>

Další informace najdete v tématu Oprávnění Siri na developer.apple.com.

Oznámení citlivá na čas

Nárok na oznámení s časovou citlivostí umožňuje aplikaci zpracovávat oznámení citlivá na čas. Oznámení citlivá na čas poskytují informace, které vyžadují okamžitou pozornost, a přímo vyzývá jednotlivce k provedení akce v okamžiku přijetí oznámení. Upozornění citlivá na čas se vždy doručují okamžitě, zobrazují se nad dalšími oznámeními a můžou přerušovat fokus a Nerušit.

Nárok je definován pomocí com.apple.developer.usernotifications.time-sensitive klíče typu Boolean:

<key>com.apple.developer.usernotifications.time-sensitive</key>
<true/>

Peněženka

Nárok na peněženku umožňuje vaší aplikaci spravovat průchody, lístky, dárkové karty a věrnostní karty. Podporuje různé formáty čárových kódů.

Nárok je definován pomocí com.apple.developer.pass-type-identifiers klíče typu ArrayString:

<key>com.apple.developer.pass-type-identifiers</key>
<array>
  <string>$(TeamIdentifierPrefix)*</string>
</array>

Tento příklad umožní aplikaci povolit všechny typy průchodů. Pokud chcete aplikaci omezit a povolit jenom sadu typů passů týmu, nastavte řetězcovou hodnotu na místo, kde $(TeamIdentifierPrefix)pass.$(CFBundleIdentifier)pass.$(CFBundleIdentifier) je ID pass.

Další informace najdete v tématu Nárok na předání ID typů na developer.apple.com.

WeatherKit

Nárok WeatherKit umožňuje aplikaci přijímat a zpracovávat aktuální a předpovídané informace o počasí.

Nárok je definován pomocí com.apple.developer.weatherkit klíče typu Boolean:

<key>com.apple.developer.weatherkit</key>
<true/>

Další informace naleznete v tématu WeatherKit Entitlement on developer.apple.com.

Konfigurace bezdrátového příslušenství

Nárok na konfiguraci bezdrátového příslušenství umožňuje aplikaci konfigurovat příslušenství Wi-Fi.

Nárok je definován pomocí com.apple.external-accessory.wireless-configuration klíče typu Boolean:

<key>com.apple.external-accessory.wireless-configuration</key>
<true/>

Další informace naleznete v tématu Oprávnění konfigurace bezdrátového přístupového objektu na developer.apple.com.