Začínáme s Unity

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

• Android
• Ios
• Rozšíření pro iOS
• React Native
• MAUI/Xamarin
• UPW
• WPF/WinForms
• Jednota
• macOS
• Rozšíření pro macOS
• tvOS

Sada App Center SDK používá modulární architekturu, abyste mohli používat libovolnou nebo všechny služby.

Pojďme začít a nastavit App Center Unity SDK pro použití App Center Analytics a monitorování pádů. Pokud chcete do aplikace přidat distribuci App Center, přečtěte si dokumentaci k distribuci v App Center.

1. Požadavky

Než začnete, ujistěte se, že je projekt nastavený v Unity 2018.1 nebo novějším.

Sada App Center SDK pro Unity podporuje následující platformy:

• iOS (9.0 nebo novější)
• Android (5.0/API 21 nebo novější)
• UWP (build 16299 nebo novější)

Poznámka:

Skriptovací verze .NET 3.5 a .NET skriptovací backend už nejsou na platformě UWP podporovány.

Pokud se chcete dozvědět, jak místo async/await s backendem .NET 3.5 používat korutiny nebo zpětná volání, nahlédněte do části Asynchronní rozhraní API v Sadě Unity SDK dokumentace.

Sada App Center SDK pro Unity je také dostupná jenom v jazyce C#.

2. Vytvoření aplikace na portálu App Center pro získání tajného kódu aplikace

Pokud jste už aplikaci vytvořili na portálu App Center, můžete tento krok přeskočit.

1. Přejděte na appcenter.ms.
2. Zaregistrujte se nebo se přihlaste do App Center.
3. Klikněte na modré tlačítko v pravém horním rohu portálu s textem Přidat nový a v rozevírací nabídce vyberte Přidat novou aplikaci .
4. Zadejte název a volitelný popis aplikace.
5. V závislosti na vašem projektu vyberte odpovídající operační systém a platformu, jak je popsáno výše.
6. Klikněte na tlačítko Přidat novou aplikaci v pravém dolním rohu stránky.

Jakmile vytvoříte aplikaci, můžete tajný kód aplikace získat na stránce Nastavení na portálu App Center. V pravém horním rohu stránky Nastavení klikněte na trojité svislé tečky a vyberte Copy app secret tajný kód aplikace.

3. Přidání sady App Center SDK do projektu

3a Instalace editoru rozšíření

Sada App Center SDK je integrovaná importem balíčků Unity do projektu. Uděláte to tak, že nejprve nainstalujete modul plug-in App Center Unity Editor Extensions . Otevřete rozšíření editoru prostřednictvím nabídky Unity: Okno > App Center > Rozšíření editoru a vyberte "Nainstalovat sadu SDK App Center".

Poznámka:

Ve verzích Unity 2019.1.2f1 a novějších může během instalace dojít k chybám v protokolech, například Coroutine continue failure. Jedná se o známý problém Unity a měli byste ho ignorovat.

3.1b Instalace jednotlivých balíčků

Jako alternativu je možné stáhnout a importovat jednotlivé balíčky Unity. Najdete je na stránce GitHub sady App Center Unity SDK. Stáhněte si nejnovější verzi balíčků, které chcete použít. Název by měl být ve formátu AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage.

3.2b Import balíčku

Otevřete projekt Unity a poklikejte na stažený balíček. V projektu Unity by se mělo zobrazit automaticky otevírané okno obsahující seznam souborů. Vyberte Importovat a sada SDK se přidá do vašeho projektu. Tento krok opakujte pro každý balíček, který jste stáhli, a naplánujte použití v projektu.

4. Povolení sady SDK

4.1 Vytvoření prázdného herního objektu

App Center funguje jako součást, kterou připojíte k hernímu objektu ve scéně, do které se hra spustí. Přejděte na tuto scénu a přidejte prázdný herní objekt. Pojmenujte ho popisným názvem, například "App Center".

4.2 Připojení skriptu App Center

V okně Projekt přejděte do složky AppCenter, která byla přidána do projektu. Vyhledejte skript s názvem AppCenterBehavior a přetáhněte ho do nově vytvořeného herního objektu v okně Hierarchie .

Poznámka:

Do každé scény, ve které ji chcete použít, nemusíte přidávat App Center. Je dostatečné ho přidat do první načtené scény.

4.3 Konfigurace nastavení App Center

Klikněte na tento nový objekt App Center a přidejte tajné kódy aplikace do odpovídajících polí v okně inspektoru . Nezapomeňte také zaškrtnout políčka Použít {service} pro každou službu App Center, kterou chcete použít.

Výstraha

Nedoporučuje se vkládat tajný kód aplikace do zdrojového kódu.

Poznámka:

Pokud váš projekt nepodporuje jednu ze tří platforem uvedených v nastavení, ponechte pole tajného kódu aplikace as-is; nebude mít žádný vliv. Pokud váš projekt podporuje platformy, které App Center nepodporuje, rozhraní API a konfigurace pro tyto platformy nebudou mít žádný vliv.

---

Skvělé, jste připraveni zobrazit na portálu data Analýzy a Diagnostiky (pády a chyby), které sada SDK automaticky shromáždí.

Podívejte se do dokumentace k App Center Analytics a App Center Crashes, abyste zjistili, jak používat pokročilejší funkce u obou služeb.

Informace o tom, jak začít s aktualizacemi v aplikaci, najdete v dokumentaci k distribuci v App Center.

5. Pravidla zálohování (jenom Android)

Poznámka:

Aplikace, které cílí na Android 6.0 (úroveň rozhraní API 23) nebo vyšší, mají automatické zálohování povolené automaticky.

Poznámka:

Pokud už máte vlastní soubor s pravidlem zálohování, přepněte na třetí krok.

Poznámka:

Pokud ještě nemáte vlastní AndroidManifest.xml soubor, vytvořte ho ve složce Assets/Plugins/Android . Tento manifest bude při sestavení sloučen s výchozím, Unity vytvořeným manifestem.

Pokud používáte automatické zálohování, abyste se vyhnuli nesprávnému získání nesprávných informací o zařízení, postupujte podle následujících kroků:

5.1. Pro Android 11 (úroveň rozhraní API 30) nebo nižší.

1. Ve složce Assets/Plugins/Android/res/xml vytvořte soubor appcenter_backup_rule.xml.

2. Otevřete soubor AndroidManifest.xml projektu. android:fullBackupContent Přidejte atribut do elementu<application>. Měl by odkazovat na soubor prostředků appcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

3. Do souboru appcenter_backup_rule.xml přidejte následující pravidla zálohování:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Pro Android 12 (úroveň rozhraní API 31) nebo vyšší.

1. Ve složce Assets/Plugins/Android/res/xml vytvořte soubor appcenter_backup_rule.xml.

2. Otevřete soubor AndroidManifest.xml projektu. android:dataExtractionRules Přidejte atribut do elementu<application>. Měl by odkazovat na soubor prostředků appcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. Do souboru appcenter_backup_rule.xml přidejte následující pravidla zálohování:

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>