Nainstalovat závislosti .NET pro Android

Abyste mohli vytvářet aplikace .NET pro Android, musíte nainstalovat sadu Android SDK a sadu Java SDK.

Použití cíle InstallAndroidDependencies

Nejjednodušší způsob, jak nainstalovat požadované závislosti pro aplikaci pro Android, je spustit InstallAndroidDependencies Cíl nástroje MSBuild.

Tento cíl prozkoumá projekt aplikace a nainstaluje přesné součásti, které jsou potřeba. Pokud projekt aktualizujete tak, aby cílil na nové rozhraní API pro Android, budete muset tento cíl spustit znovu, abyste měli jistotu, že získáte požadované součásti.

Pokud například upgradujete projekt na cílové rozhraní API 34 z rozhraní API 32, budete mít nainstalované jenom rozhraní API 32. Spuštěním cíle InstallAndroidDependencies se nainstaluje rozhraní API 34.

Pokud ani nemáte nainstalovanou sadu Android SDK, tento cílový prvek může také zpracovat instalaci Android SDK na čistém počítači. Cíl instalace můžete změnit nastavením AndroidSdkDirectory vlastnosti MSBuild. Pokud je k dispozici vlastnost MSBuild, JavaSdkDirectory nainstaluje se také sada Java SDK.

dotnet build -t:InstallAndroidDependencies -f net8.0-android -p:AndroidSdkDirectory=c:\work\android-sdk -p:JavaSdkDirectory=c:\work\jdk -p:AcceptAndroidSdkLicenses=True

Tady jsou všechny argumenty, které cíl použije při instalaci závislostí:

  • -p:AndroidSdkDirectory="<PATH>" nainstaluje nebo aktualizuje závislosti Androidu na zadanou cestu.
    Poznámka: Musíte použít absolutní cestu; vývojáři systému Unix by neměli používat vlnovku (~), protože není rozšířena při použití jako argument příkazového řádku.

  • -p:JavaSdkDirectory="<PATH>" nainstaluje Javu na zadanou cestu.
    Poznámka: Musíte použít absolutní cestu; vývojáři systému Unix by neměli používat vlnovku (~), protože není rozšířena při použití jako argument příkazového řádku.

  • -p:AcceptAndroidSDKLicenses=True přijímá potřebné licence pro Android pro vývoj.

Poznámka:

Chcete-li usnadnit vývoj, snažte se vyhnout použití cest obsahujících mezery nebo znaky jiné než ASCII.

Ruční instalace sady Microsoft JDK

Abyste mohli vytvářet .NET pro aplikace nebo knihovny pro Android, musíte mít nainstalovanou verzi sady Java Development Kit. Doporučujeme používat sadu Microsoft Open JDK, která byla testována na našich buildech .NET pro Android:

  1. Stáhněte si Microsoft OpenJDK 21.

  2. V závislosti na vaší platformě spusťte příslušný instalační program.

  3. Je také vhodné nastavit proměnnou JAVA_HOME prostředí. To vám umožní používat sadu JDK z příkazového řádku nebo terminálu.

Ruční instalace sady Android SDK

Poznámka:

Ve Windows budete muset nejdřív nainstalovat sadu JDK.

Možná budete muset sadu Android SDK nainstalovat ručně:

  1. Přejděte na Android Studio ke stažení.
    Posuňte se dolů do části Nástroje příkazového řádku a stáhněte soubor ZIP pro váš operační systém.

  2. Vytvořte adresář android-sdk někde na pevném disku. Aby byl váš život jednodušší, vytvořte ho poblíž kořene jednotky. Příklad: c:\android-sdk.

  3. Extrahujte soubory ze souboru ZIP do tohoto adresáře. Měli byste mít strukturu složek, jako je například android-sdk\cmdline-tools

  4. Otevřete terminál nebo příkazový řádek.

  5. Přejděte do android-sdk\cmdline-tools\bin adresáře v adresáři, který jste vytvořili.

  6. Spuštěním sdkmanager příkazu nainstalujte požadované součásti.

  7. Nastavte proměnnou $ANDROID_HOME prostředí na cestu sady Android SDK:

    $env:ANDROID_HOME = "C:\android-sdk"
    

Pokud chcete například nainstalovat nejnovější platformu a nástroje platformy, použijte:

sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0" "emulator" "system-images;android-34;default;x86_64" "cmdline-tools;latest" --sdk_root=c:\android-sdk

Všimněte si, že dvojité uvozovky by měly být liberálně použity k uzavření středníku ;, který je součástí názvů komponent.

Zobrazí se výzva k přijetí licence, po které se sada Android SDK nainstaluje.

Můžete použít sdkmanager k instalaci dalších komponent. Pomocí argumentu --list můžete získat seznam všech dostupných komponent. Pak se můžete podívat na seznam a najít další požadované součásti.

sdkmanager --list

Následující typy komponent jsou užitečné vědět:

  • platforms;android-XX: Nainstaluje platformu android-XX do sady SDK. Nahraďte XX úrovní rozhraní API zvolené platformy. Například platforms;android-30 nainstaluje rozhraní Android API 30, zatímco platforms;android-21 se nainstaluje rozhraní Android API 21.

  • system-images;android-XX;default;x86_64: Nainstaluje image emulátoru pro konkrétní úroveň rozhraní API. x86_64 lze zaměnit za různé ABI, jako je x86, arm64-v8a a x86_64. Ty odrážejí ABI instalovaného obrazu. To může být užitečné, pokud máte problémy s konkrétními ABI.

Je také vhodné nastavit ANDROID_HOME proměnnou prostředí, protože to umožňuje používat určité nástroje z příkazového řádku.