Sdílet prostřednictvím

Vytváření aplikací Xamarin pro Android

  • Článek

Důležité

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

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

Pokud chcete začít vytvářet svou první aplikaci Xamarin pro Android, musíte:

  1. Připojte se ke svému účtu služby úložiště (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Vyberte úložiště a větev, ve které se nachází vaše aplikace.
  3. Zvolte projekt pro Android, který chcete sestavit.
  4. Nastavte svůj první build.

Poznámka

Aby aplikace běžela na skutečném zařízení, musíte sestavení podepsat platným úložištěm klíčů.

1. Propojení úložiště

Pokud jste se ještě nepřipojili k účtu služby úložiště, musíte to udělat jako první. Jakmile je váš účet připojený, vyberte úložiště, ve kterém se nachází projekt Xamarin. K nastavení sestavení pro úložiště musíte mít oprávnění správce a přijetí změn.

2. Výběr větve

Po výběru úložiště vyberte větev, kterou chcete vytvořit. App Center ve výchozím nastavení zobrazuje seznam všech aktivních větví.

3. Konfigurace sestavení

Projekt Xamarin musí být nakonfigurovaný před prvním sestavením.

3.1. Aktivační události sestavení

Služba sestavení ve výchozím nastavení používá kontinuální integraci, takže se nové sestavení aktivuje pokaždé, když vývojář odešle změny do nakonfigurované větve. Pokud dáváte přednost ruční aktivaci nových sestavení, můžete toto nastavení změnit v podokně konfigurace.

3.2. Projekt a konfigurace

Dostupné projekty ve vašem úložišti se naplní, pokud se nacházejí v rozsahu analýzy. Vyberte správný projekt pro váš build pro Android a vyberte vhodnou konfiguraci.

Poznámka

Pro zajištění nejlepšího výkonu je analýza v současné době omezená na čtyři úrovně adresáře, včetně kořenového adresáře úložiště.

3.3. Mono verze

App Center umožňuje pro vaše sestavení používat různá prostředí Mono, která jsou součástí příslušné sady Xamarin.Android SDK. Díky tomu udržujeme zpětnou kompatibilitu a zároveň podporujeme nejnovější funkce. Výchozí mono verze pro konfiguraci nové větve je nejnovější stabilní verze. K vytváření starších verzí architektur nebo knihoven můžete použít jedno z předchozích prostředí Mono.

Při výběru monoverze v konfiguraci sestavení se přímo vedle ní zobrazí přibalená verze sady Xamarin.Android SDK. Další informace o aktualizacích verzí sady Xamarin SDK najdete na blogu o vydáních Xamarinu.

3.3.1. Verze .NET Core

Správná verze .NET Core se vybere automaticky na základě mono verze použité k sestavení a nepůjde přepsat. Mapování Mono na .NET Core používané našimi službami najdete v následující tabulce:

Mono .NET Core
<= 5,18 2.2.105
6.0 2.2.300
6.4 3.0.100
6.6 3.1.100
6.8 3.1.200
6.10 3.1.300
6.12 3.1.401

3.4. Sestavení sady aplikací pro Android (.aab)

Sada aplikací pro Android je distribuční formát, který slouží ke generování optimalizovaných sad API pro konkrétní zařízení. Dá se nahrát do Obchodu Play. Další informace o sadě aplikací pro Android najdete v oficiální dokumentaci k Androidu a ve zprávě k vydání verze Xamarin.Android 9.4, která vám také může pomoct při rozhodování, jestli chcete společně s běžnými sadami vytvořit balíček. .apk.

Zapněte možnost Sady aplikací pro Android, abyste vytvořili .aab.apka . .csproj Pokud soubor obsahuje aab vlastnost AndroidPackageFormat , tato možnost se automaticky zapne. .aab Sestavení je podporováno pro Xamarin.Android 9.4 a novější.

3.5. Zvýšení čísla verze

Pokud je tato možnost povolená, kód verze v AndroidManifest.xml vaší aplikace se automaticky zvýší pro každé sestavení. Ke změně dojde před sestavením a nebude potvrzena do vašeho úložiště.

3.6. Podepisování kódu

Úspěšné sestavení vytvoří .apk soubor a další .aab soubor, pokud je povoleno. Pokud chcete build vydat do Obchodu Play, musí být podepsaný platným úložištěm klíčů a aliasem. Pokud chcete podepsat sestavení vygenerovaná z větve, povolte podepisování kódu v podokně konfigurace, nahrajte úložiště klíčů a zadejte požadované hodnoty v podokně konfigurace. Můžete si přečíst podrobnější pokyny k podepisování kódu. Podepíše .aab se stejnými přihlašovacími údaji jako ..apk

3.7. Spuštění úspěšného buildu na skutečném zařízení

Pomocí nově vytvořeného .apk souboru otestujte, jestli se aplikace spustí na skutečném zařízení. K celkovému času sestavení se tím přičte přibližně o 10 minut více. Další informace najdete v našem průvodci testovací integrací.

3.8. Obnovení NuGet

NuGet.config Pokud je soubor vrácený se změnami v úložišti a nachází se .sln vedle souboru nebo na kořenové úrovni úložiště, App Center po přidání obnoví vaše privátní informační kanály NuGet, jak je znázorněno v následujícím příkladu. Přihlašovací údaje je možné bezpečně přidat pomocí proměnných prostředí:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget" value="https://api.nuget.org/v3/index.json" />
    <add key="MyGet" value="https://www.myget.org/F/MyUsername/api/v2/index.json" />
    <add key="MyAuthNuget" value="https://nuget.example.com/v2/index.json" />
  </packageSources>
  <activePackageSource>
    <add key="All" value="(Aggregate source)" />
  </activePackageSource>
  <packageSourceCredentials>
    <MyAuthNuget>
      <add key="Username" value="$USER_VARIABLE" />
      <add key="ClearTextPassword" value="$PASSWORD_VARIABLE" />
    </MyAuthNuget>
  </packageSourceCredentials>
</configuration>

Pokud máte složité konfigurace a potřebujete další informace, přečtěte si téma Konfigurace chování NuGetu.

3.9. Distribuce sestavení

Každé úspěšné sestavení z větve můžete nakonfigurovat tak, aby se distribuovala do dříve vytvořené distribuční skupiny nebo cíle úložiště. Ve službě Distribute můžete přidat novou distribuční skupinu nebo nakonfigurovat připojení k úložišti . Vždy existuje výchozí distribuční skupina s názvem Spolupracovníci, která zahrnuje všechny uživatele, kteří mají k aplikaci přístup.

Poznámka

Pokud se distribuuje do Obchodu Google Play, upřednostňuje se sada aplikací pro Android (.aab), která se distribuuje, pokud je povolená. Pro distribuční skupiny App Center a cíle Intune storu se použije běžný .apk způsob, i když .aab se vygeneruje také .

4. Výsledky sestavení

Po triggeru sestavení bude sestavení v jednom z následujících stavů:

  • ve frontě – sestavení je ve frontě, která čeká na uvolnění prostředků.
  • building – sestavení je spuštěné.
  • succeeded – sestavení bylo úspěšně dokončeno.
  • failed – sestavení se zastavilo s chybami. Problém můžete vyřešit stažením a kontrolou protokolu sestavení.
  • zrušeno – sestavení bylo zrušeno akcí uživatele nebo vypršel jeho časový limit.

4.1. Protokoly sestavení

V případě dokončeného sestavení (úspěšného nebo neúspěšného) si stáhněte protokoly, abyste získali další informace o tom, jak sestavení proběhlo. App Center poskytuje archiv s následujícími soubory:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Protokoly kroků sestavení (umístěné v build/ adresáři archivu) jsou užitečné pro pochopení toho, v jakém kroku a proč sestavení selhalo.

4.2. Aplikace (.apk)

Soubor .apk je zabalený soubor aplikace pro Android, který ukládá aplikaci pro Android. Pokud je sestavení správně podepsané, .apk soubor se dá nainstalovat na skutečné zařízení a nasadit ho do Obchodu Play. Pokud sestavení není podepsané, může aplikace běžet v emulátoru nebo se použít k jiným účelům.

Podporované verze a požadavky

App Center podporuje projekty PCL (Portable Class Library) a .NET Standard . Verze rozhraní .NET Standard najdete v tématu Cloud Build Machines .

App Center nepodporuje komponenty z úložiště komponent Xamarin a doporučujeme používat balíčky NuGet vždy, když jsou k dispozici. Pokud používáte komponentu, kterou nejde nahradit, kontaktujte nás. Podívejte se na nápovědu a zpětnou vazbu.