# ITMS-91053: oprava „Missing API declaration“ v Expo

> ITMS-91053: tvůj build používá API s povinným důvodem a nedeklaruje ho. Přidej kategorii a kód do ios.privacyManifests a udělej nový build.

Původní stránka: [ITMS-91053: oprava „Missing API declaration“ v Expo](https://devoria.fr/cs/blog/itms-91053-missing-api-declaration-expo)
Autor: [Mehdi Azizi](https://devoria.fr/cs/mehdi-azizi)
Publikováno: 2026-10-25
Poslední revize obsahu: 2026-10-25


ITMS-91053 je automatická kontrola Applu, kterou dostaneš e-mailem po [odeslání buildu](https://devoria.fr/cs/blog/eas-submit-ios-publikovat-expo-app-app-store). Říká, že kód tvé appky používá API „s povinným důvodem“ (preference, data souborů, čas od spuštění systému, místo na disku nebo klávesnice) a v manifestu soukromí nevysvětluje proč. **V Expo se to opravuje v `ios.privacyManifests`: kategorie, kterou Apple uvádí, kód popisující tvé skutečné použití a pak nový build.**

V Solys, mém budíku s minihrami, jsou tyhle důvody deklarované v konfiguraci appky. Ukážu ti její skutečnou deklaraci, příkaz, který vypíše, co používají tvoje závislosti, a kontrolu výsledného souboru před odesláním.

## Co znamená chyba ITMS-91053?

Zpráva má název „ITMS-91053: Missing API declaration“. Říká, že kód v konkrétním souboru tvého buildu odkazuje na jedno nebo víc API, která vyžadují důvod. Pak vypíše dotčené kategorie, třeba `NSPrivacyAccessedAPICategoryUserDefaults`.

Tahle API po uživateli nechtějí žádné oprávnění. Dají se ale použít k rozpoznání zařízení, čemuž Apple říká fingerprinting. To je zakázané, i když uživatel se sledováním souhlasí. Apple to vysvětluje na stránce o [API s povinným důvodem](https://developer.apple.com/documentation/bundleresources/describing-use-of-required-reason-api): každá appka a každé SDK musí deklarovat, proč je používá.

Stejná stránka stanovuje pravidlo: **od 1. května 2024 App Store Connect nepřijme appku, která tato použití nepopisuje ve svém manifestu.** Někteří vývojáři hlásili tenhle e-mail jen jako varování u přijatého buildu. Nespoléhej na to: ber to jako blokaci a oprav to před dalším odesláním.

Stejně jako ostatní chyby ITMS to není zamítnutí od revieweru. Nikdo tvou appku neotevřel: Apple analyzoval binárku.

## Privacy manifest v iOS: soubor PrivacyInfo.xcprivacy

Manifest soukromí je soubor `PrivacyInfo.xcprivacy` v kořeni bundlu appky. Podle [dokumentace Applu k privacy manifestům](https://developer.apple.com/documentation/bundleresources/privacy-manifest-files) popisuje sbíraná data, sledování a API s povinným důvodem. Ta patří do pole `NSPrivacyAccessedAPITypes`: jedna položka na kategorii, s typem a seznamem důvodů.

Tady je past: **manifest pokrývá jen svůj vlastní bundle.** Apple to píše přímo: každý spustitelný soubor nebo dynamická knihovna, která tato API používá, musí mít manifest ve svém bundlu. Manifest tvé appky nepokrývá vložený framework a SDK se nemůže spoléhat na manifest tvé appky.

Nepleť si ho s texty v Info.plist, které vyžaduje [ITMS-90683](https://devoria.fr/cs/blog/itms-90683-missing-purpose-string-expo). Ty se uživateli zobrazí v žádosti o oprávnění. Manifest čte jen Apple.

## 5 kategorií API a jejich kódy důvodů

Celý název kategorie začíná `NSPrivacyAccessedAPICategory`. Seznam API a důvodů najdeš na stránce klíče [NSPrivacyAccessedAPIType](https://developer.apple.com/documentation/bundleresources/app-privacy-configuration/nsprivacyaccessedapitypes/nsprivacyaccessedapitype), přečteno 15. října 2026.

| Kategorie       | Typické API                  | Běžný důvod |
| --------------- | ---------------------------- | ----------- |
| UserDefaults    | `UserDefaults`               | CA92.1      |
| FileTimestamp   | `creationDate`               | C617.1      |
| SystemBootTime  | `systemUptime`               | 35F9.1      |
| DiskSpace       | `volumeAvailableCapacityKey` | E174.1      |
| ActiveKeyboards | `activeInputModes`           | 54BD.1      |

Kódy, na které narazíš nejčastěji:

- **CA92.1**: appka čte a zapisuje své vlastní preference, nedostupné jiným appkám.
- **1C8F.1**: preference sdílené s widgetem nebo rozšířením ve stejné App Group.
- **C617.1**: data nebo velikost souborů uložených v kontejneru appky.
- **3B52.1**: soubory, které vybral uživatel, třeba v dialogu pro výběr dokumentů.
- **35F9.1**: měření času mezi dvěma událostmi v appce nebo běh časovače.
- **E174.1**: kontrola volného místa před zápisem souborů, s viditelným dopadem pro uživatele.
- **85F4.1**: zobrazení místa na disku uživateli.

**Deklaruj důvod, který odpovídá tvému skutečnému použití, ne ten, co vypadá nejširší.** Apple upřesňuje, že tato API a jejich data slouží jen k deklarovaným důvodům a nikdy ke sledování. Dva kódy jsou vyhrazené pro SDK třetích stran: C56D.1 a 0A2A.1. V manifestu tvé appky nemají co dělat.

## Deklarace privacy manifestu v Expo

V Expo ten soubor nepíšeš sám. Popíšeš ho pod `expo.ios.privacyManifests` v app.json nebo app.config a prebuild vygeneruje `PrivacyInfo.xcprivacy`. To je postup z [dokumentace Expo k privacy manifestům](https://docs.expo.dev/guides/apple-privacy/).

Tady je skutečný výřez z konfigurace Solys. Klíč obsahuje i sledování a sbíraná data, ta jsem tu vynechal:

```json
{
  "expo": {
    "ios": {
      "privacyManifests": {
        "NSPrivacyAccessedAPITypes": [
          {
            "NSPrivacyAccessedAPIType": "NSPrivacyAccessedAPICategoryUserDefaults",
            "NSPrivacyAccessedAPITypeReasons": ["CA92.1", "1C8F.1"]
          },
          {
            "NSPrivacyAccessedAPIType": "NSPrivacyAccessedAPICategoryFileTimestamp",
            "NSPrivacyAccessedAPITypeReasons": ["C617.1"]
          },
          {
            "NSPrivacyAccessedAPIType": "NSPrivacyAccessedAPICategorySystemBootTime",
            "NSPrivacyAccessedAPITypeReasons": ["35F9.1"]
          }
        ]
      }
    }
  }
}
```

CA92.1, C617.1 a 35F9.1 přebírají to, co deklaruje React Native a moduly Expo v appce. 1C8F.1 pochází přímo ze Solys: appka sdílí nastavení se svým widgetem přes App Group.

Past, o které je dobré vědět: pokud je tvoje složka `ios` generovaná a ignorovaná gitem, **ručně napsaný `PrivacyInfo.xcprivacy` v téhle složce se do buildu nikdy nedostane.** EAS znovu spustí prebuild a složku přegeneruje. Ověřil jsem si to na jednom svém projektu 9. září 2026: ručně napsaný manifest po prebuildu zmizel. Deklarace musí žít v konfiguraci.

Poslední věc: manifest je součástí binárky. Vzdálená aktualizace ho nezmění. Musíš udělat nový build a znovu ho odeslat.

## SDK třetích stran s vlastním manifestem

Většina novějších knihoven svůj manifest dodává. Balíčky Expo, které tato API používají, mají `PrivacyInfo.xcprivacy` ve své složce `ios`, stejně jako React Native. Problém je v tom, jak jsou k tvé appce připojené.

Dokumentace Expo varuje: Apple nečte správně všechny manifesty závislostí CocoaPods linkovaných staticky, což je případ balíčků Expo. Může se tedy stát, že jejich důvody budeš muset zkopírovat do konfigurace své appky.

Aby té práce bylo méně, nastavení `ios.privacyManifestAggregationEnabled` z [expo-build-properties](https://docs.expo.dev/versions/latest/sdk/build-properties/) slučuje manifesty závislostí CocoaPods do jednoho souboru. V Podfilu, který Expo generuje na mých projektech (SDK 57), je toto slučování zapnuté, pokud ho nevypneš.

Slučování má jeden limit: vidí jen závislosti, které manifest dodávají. Starší knihovna bez manifestu zůstane neviditelná. **Přečti si proto cestu k souboru uvedenou v e-mailu**: říká ti, kde opravovat.

| Uvedený soubor           | Kde opravit            |
| ------------------------ | ---------------------- |
| Spustitelný soubor appky | `ios.privacyManifests` |
| `.framework`             | Aktualizovat SDK       |
| Rozšíření `.appex`       | Manifest rozšíření     |

## Kontrola před odesláním

Expo navrhuje po odeslání počkat na e-mail od Applu. Funguje to, ale každé kolečko stojí jeden build. Tady jsou čtyři kontroly, které dělám předem.

**1. Vypiš, co deklarují tvoje závislosti.** Z kořene projektu:

```bash
find node_modules -name PrivacyInfo.xcprivacy -not -path '*/example/*' \
  -exec grep -ho "NSPrivacyAccessedAPICategory[A-Za-z]*" {} + | sort | uniq -c
```

U Solys příkaz 15. října 2026 našel 13 manifestů a čtyři kategorie: data souborů, preference, čas od spuštění systému a místo na disku. Každá vypsaná kategorie se musí objevit ve výsledném manifestu appky, nebo v manifestu frameworku, který ji používá.

**2. Prohledej svůj vlastní nativní kód.** Vlastní moduly, pluginy, targety jako widget: tenhle kód za tebe žádné SDK nedeklaruje.

```bash
grep -rlE "UserDefaults|systemUptime|mach_absolute_time|creationDate|modificationDate|volumeAvailableCapacity|activeInputModes" \
  --include='*.swift' --include='*.m' --include='*.mm' modules plugins targets
```

Složky si uprav podle svého projektu. U Solys právě tohle hledání odhalí preference sdílené přes App Group, odtud kód 1C8F.1.

**3. Přečti si vygenerovaný manifest.** Spusť `npx expo prebuild -p ios` a otevři `ios/<NazevTveAppky>/PrivacyInfo.xcprivacy`. Pozor: tenhle příkaz může složku `ios` smazat a vytvořit znovu. Pokud v ní máš ruční úpravy, pracuj na kopii projektu.

**4. Zkontroluj výsledný build.** To je jediný důkaz, který se počítá. Stáhni IPA ze stránky buildu na expo.dev a na Macu spusť:

```bash
unzip -q MojeAppka.ipa -d ipa
find ipa/Payload -name PrivacyInfo.xcprivacy
plutil -p ipa/Payload/*.app/PrivacyInfo.xcprivacy
```

Druhý řádek vypíše všechny vložené manifesty, appky i frameworků. Třetí zobrazí manifest appky, který porovnáš se seznamem z kroku 1.

## Co musí manifest říkat ve shodě s tvou stránkou v App Storu

Manifest nežije sám. Pokud deklaruje sledování nebo sbíraná data, tvoje stránka v App Storu a zásady ochrany osobních údajů musí říkat totéž. Nesoulad mezi těmi třemi tě pak může stát lidské zamítnutí podle [guideline 5.1.1](https://devoria.fr/cs/blog/guideline-5-1-1-zamitnuti-app-store). Co je potřeba sladit, najdeš v článku [zásady ochrany osobních údajů aplikace](https://devoria.fr/cs/blog/zasady-ochrany-osobnich-udaju-ios-aplikace).

## Odešli build bez nepříjemných překvapení

Chyby ITMS se opravují rychle, když je umíš číst. Zamítnutí, která přijdou potom, chtějí víc nadhledu: postup je na stránce [aplikace zamítnutá Applem](https://devoria.fr/cs/expertise/aplikace-zamitnuta-applem) a nejčastější důvody najdeš v článku [proč Apple zamítá appky](https://devoria.fr/cs/blog/apple-zamitl-aplikaci-duvody).

Pro kontrolu před odesláním obsahuje [Apple Review Kit](https://devoria.fr/cs/kits/review-apple) můj checklist a skills pro Claude Code, které projdou tvůj projekt. Pokud se ti odeslání zaseklo a chceš lidský pohled, [zarezervuj si se mnou hodinu](https://devoria.fr/cs/coaching): projdeme tvůj projekt přes videohovor, na tvé obrazovce. A pokud chystáš své první vydání, [udělej si bezplatnou diagnostiku](https://devoria.fr/cs/diagnostic): seřadí ti kroky a pošle ti můj checklist proti zamítnutí od Applu.

## Časté dotazy

### Blokuje ITMS-91053 odeslání mého buildu?

Apple píše, že od 1. května 2024 App Store Connect nepřijímá appky, které nepopisují použití těchto API. Někteří vývojáři ale e-mail dostali u přijatého buildu jako varování. V obou případech oprav manifest před dalším buildem.

### Jaký kód důvodu zvolit pro UserDefaults?

CA92.1, pokud appka čte a zapisuje jen své vlastní preference. Přidej 1C8F.1, pokud je sdílí s widgetem nebo rozšířením přes App Group. C56D.1 je vyhrazený pro SDK třetích stran: do manifestu své appky ho nedávej.

### Musím do app.json kopírovat manifest každého SDK?

Ne nutně. Pokud je slučování manifestů zapnuté, manifesty závislostí CocoaPods se spojí při instalaci podů. Kategorii zkopíruj jen tehdy, když ve výsledném manifestu chybí, a to s důvodem, který popisuje skutečné použití.

### Potřebuje můj widget nebo rozšíření vlastní manifest?

Podle Applu musí mít každý bundle se spustitelným souborem, který tato API používá, vlastní manifest. Rozšíření je samostatný spustitelný soubor ve vlastním bundlu: manifest appky ho nepokrývá.

### Dá se ITMS-91053 opravit bez nového buildu?

Ne. Manifest soukromí je součástí binárky. Oprav konfiguraci, udělej nový build a pak ho otestuj v [TestFlight](https://devoria.fr/cs/blog/testflight-testovani-iphone-aplikace), než ho pošleš do review.


## Tvůj projekt

[Apple Review Kit](https://devoria.fr/cs/kits/review-apple): Checklist pro App Store review, který používám, moje opravená zamítnutí od Applu, poznámky pro testera a dva skills pro Claude Code, které zkontrolují tvou aplikaci. 29 €.

[iOS Kit](https://devoria.fr/cs/kits/ios): Vytvoř svou iPhone aplikaci s Claude Code: startovní kód mých aplikací, skills, které kontrolují jeho práci, a Apple Review Kit, App Store Screenshots Kit a ASO Kit. 129,99 €.