Řešení potíží se sadou macOS SDK

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.

Přečtěte si další informace o časových osách a alternativách podpory.

Problémy během instalace

  1. V konzole vyhledejte protokol Assert se zprávou "Sada App Center SDK byla úspěšně nakonfigurována". Tím se ověří, že se sada SDK úspěšně nakonfigurovala.
  2. Pokud k integraci App Center do aplikace pro macOS používáte Cocoapods a narazíte na chybu se zprávou – CocoaPods - Unable to find a specification for AppCenter, spusťte příkaz pod repo update pro aktualizaci místního úložiště Cocoapods a pak spusťte pod install příkaz znovu.
  3. Pokud binární soubory sady SDK integrujete ručně, ujistěte se, že jsou pro váš projekt povolené moduly.

Analytická data se na portálu nezobrazují.

  1. Ujistěte se, že jste správně integrovali moduly sady SDK.

  2. Ujistěte se, že je spolu s voláním start:withServices: metody zahrnutý správný tajný kód aplikace. Přesný start:withServices:kód můžete zkopírovat tak, že aplikaci otevřete na portálu a přejdete na Začínáme stránku.

  3. Pokud chcete zobrazit protokoly odesílané do back-endu, změňte ve vaší aplikaci úroveň protokolu na Podrobná a sada SDK protokoly vytiskne v konzole. Před spuštěním sady SDK vložte následující volání:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
    
    AppCenter.logLevel = .verbose
    

    Ujistěte se, že se v protokolech (na úrovni protokolu INFO ) zobrazuje zpráva App Center SDK se úspěšně nakonfigurovaná, a pak zkontrolujte, jestli se zobrazují protokoly požadavků HTTPS.

  4. Ujistěte se, že je vaše zařízení online a aplikace má přístup k internetu.

    Poznámka

    Pokud vaše aplikace používá sandbox aplikací, musíte nastavit možnost povolit příchozí (serverová) a odchozí (klientská) připojení, aby aplikace měla přístup k internetu. Xcode 9 ve výchozím nastavení povoluje sandbox aplikací, ale možnosti příchozích a odchozích připojení je potřeba explicitně nastavit.

    V navigátoru projektu vyberte projekt, vyberte kartu Schopnosti a pokud vaše aplikace používá sandbox, přidejte možnosti pro příchozí a odchozí připojení.

  5. Někdy může trvat několik minut, než se protokoly na portálu projeví. Počkejte nějakou dobu, jestli je to tak.

  6. Pokud chcete zkontrolovat, jestli back-end App Center přijal vaše data, přejděte do části Tok protokolu ve službě Analytics . Vaše události by se měly zobrazit po odeslání.

Na portálu se nezobrazují chybové ukončení.

  1. Ujistěte se, že jste správně integrovali moduly sady SDK.

  2. Ujistěte se, že je spolu s voláním start:withServices: metody zahrnutý správný tajný kód aplikace. Přesný start:withServices: kód můžete zkopírovat tak, že aplikaci otevřete na portálu a přejdete na Začínáme stránku.

  3. Po chybovém ukončení restartujte aplikaci. Chybové ukončení App Center přesměruje protokol chybových ukončení až po restartování aplikace. Sada SDK také nepředá žádné protokoly chybových ukončení, pokud jste připojeni k ladicím programu. Ujistěte se, že ladicí program není připojený při chybovém ukončení aplikace.

  4. Pokud chcete zobrazit protokoly odesílané do back-endu, změňte ve vaší aplikaci úroveň protokolu na Podrobná a sada SDK protokoly vytiskne v konzole. Před spuštěním sady SDK vložte následující volání:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
    
    AppCenter.logLevel = .verbose
    

    Ujistěte se, že se v protokolech (na úrovni protokolu INFO ) zobrazuje zpráva App Center SDK se úspěšně nakonfigurovaná, a pak zkontrolujte, jestli se zobrazují protokoly požadavků HTTPS.

  5. Nepoužívejte žádné jiné knihovny, které poskytují funkci zasílání zpráv o chybách. Do aplikace můžete mít integrovanou jenom jednu sadu SDK pro zasílání zpráv o chybách.

  6. Ujistěte se, že je vaše zařízení online a aplikace má přístup k internetu.

    Poznámka

    Pokud vaše aplikace používá sandbox aplikací, musíte nastavit možnost povolit příchozí (serverová) a odchozí (klientská) připojení, aby aplikace měla přístup k internetu. Xcode 9 ve výchozím nastavení povoluje sandbox aplikací, ale možnosti příchozích a odchozích připojení je potřeba explicitně nastavit.

    V navigátoru projektu vyberte projekt, vyberte kartu Schopnosti a pokud vaše aplikace používá sandbox, povolte příchozí a odchozí připojení.

  7. Občas může trvat několik minut, než se protokoly na portálu budou moct zobrazit. Počkejte nějakou dobu, jestli je to tak.

  8. Pokud chcete zkontrolovat, jestli sada SDK zjistila chybové ukončení při dalším spuštění aplikace, můžete voláním rozhraní API zkontrolovat, jestli aplikace v poslední relaci nespadla a jestli se zobrazuje upozornění. Nebo můžete zpětné volání při selhání didSucceedSendingErrorReport rozšířit a zjistit, jestli bylo úspěšně odesláno na server.

  9. Pokud chcete zkontrolovat, jestli back-end App Center přijal chybové ukončení, přejděte do části Tok protokolu ve službě Analytics. Po odeslání by se tam měla objevit chyba.

Ochrana hodnoty tajného klíče App Center

Jedná se app_secret o identifikátor vaší aplikace, je potřeba vědět, na kterou aplikaci se provoz vztahuje, a nelze ho použít k načtení nebo úpravám existujících dat. Pokud je váš app_secret problém vystavený, největší riziko spočívá v odesílání chybných dat do aplikace, ale nebude to mít vliv na zabezpečení dat.

Pokud chcete načíst citlivá data, musíte zadat token aplikace nebo uživatele, který se vygeneruje na straně klienta. Neexistuje žádný způsob, jak zajistit úplné zabezpečení dat na straně klienta.

Zabezpečení aplikace můžete zlepšit pomocí proměnné prostředí pro vložení tajného kódu aplikace do kódu. Tajný kód tak nebude v kódu viditelný.