Bagikan melalui


Menginstal .NET untuk dependensi Android

Untuk membangun .NET untuk aplikasi Android, Anda perlu menginstal Android SDK dan Java SDK.

Menggunakan target "InstallAndroidDependencies"

Cara term mudah untuk menginstal dependensi yang diperlukan untuk aplikasi Android Anda adalah dengan menjalankan InstallAndroidDependencies Target MSBuild.

Target ini akan memeriksa proyek aplikasi Anda dan menginstal komponen yang tepat yang diperlukan. Jika Anda memperbarui proyek untuk menargetkan ANDROID API baru, Anda harus menjalankan target ini lagi untuk memastikan Anda mendapatkan komponen yang diperlukan.

Misalnya jika Anda meningkatkan proyek untuk menargetkan API 34 dari API 32, Anda hanya akan menginstal API 32. Menjalankan target InstallAndroidDependencies akan menginstal API 34 untuk Anda.

Jika Anda tidak menginstal Android SDK sama sekali, target ini juga dapat menangani penginstalan SDK pada komputer yang bersih. Anda dapat mengubah tujuan penginstalan dengan mengatur AndroidSdkDirectory properti MSBuild. Ini juga akan menginstal Java SDK jika JavaSdkDirectory properti MSBuild disediakan.

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

Berikut adalah semua argumen yang akan digunakan target saat menginstal dependensi:

  • -p:AndroidSdkDirectory="<PATH>" menginstal atau memperbarui dependensi Android ke jalur yang ditentukan.
    Catatan: Anda harus menggunakan jalur absolut; Pengembang Unix tidak boleh menggunakan tilde (~), karena tidak diperluas saat digunakan dalam argumen baris perintah.

  • -p:JavaSdkDirectory="<PATH>" menginstal Java ke jalur yang ditentukan.
    Catatan: Anda harus menggunakan jalur absolut; Pengembang Unix tidak boleh menggunakan tilde (~), karena tidak diperluas saat digunakan dalam argumen baris perintah.

  • -p:AcceptAndroidSDKLicenses=True menerima lisensi Android yang diperlukan untuk pengembangan.

Nota

Untuk mempermudah pengembangan, coba hindari menggunakan jalur yang berisi spasi atau karakter non-ASCII.

Menginstal Microsoft JDK secara manual

Untuk membangun .NET untuk aplikasi atau pustaka Android, Anda harus menginstal versi Java Development Kit. Kami sarankan Anda menggunakan Microsoft Open JDK, ini telah diuji terhadap build .NET untuk Android kami:

  1. Unduh Microsoft OpenJDK 21.

  2. Bergantung pada platform Anda, jalankan alat penginstal yang sesuai.

  3. Ini juga merupakan praktik yang baik untuk mengatur JAVA_HOME variabel lingkungan. Ini akan memungkinkan Anda untuk menggunakan JDK dari Prompt Perintah atau Terminal.

Menginstal Android SDK secara manual

Nota

Pada Windows Anda harus menginstal JDK terlebih dahulu.

Anda mungkin merasa perlu menginstal Android SDK secara manual:

  1. Buka unduhan Android Studio.
    Gulir ke bawah ke bagian "Alat Baris Perintah saja" dan unduh file zip untuk sistem operasi Anda.

  2. android-sdk Buat direktori di suatu tempat di hard drive Anda. Untuk membuat hidup Anda lebih mudah membuatnya dekat dengan akar drive. Contoh: c:\android-sdk.

  3. Ekstrak file dari file zip ke direktori ini. Anda sebaiknya memiliki struktur folder seperti android-sdk\cmdline-tools

  4. Buka terminal atau Command Prompt.

  5. Arahkan ke direktori android-sdk\cmdline-tools\bin dalam direktori yang telah Anda buat.

  6. Jalankan sdkmanager perintah untuk menginstal komponen yang diinginkan.

  7. Atur $ANDROID_HOME variabel lingkungan ke jalur Android SDK Anda:

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

Misalnya, untuk menginstal platform dan alat platform terbaru, gunakan:

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

Perhatikan bahwa tanda kutip ganda harus digunakan secara liberal untuk mengapit titik koma ;, yang merupakan bagian dari nama komponen.

Anda akan diminta untuk menerima lisensi, setelah itu Android SDK akan diinstal.

Anda dapat menggunakan sdkmanager untuk menginstal komponen tambahan. Anda dapat menggunakan --list argumen untuk mendapatkan daftar semua komponen yang tersedia. Anda kemudian dapat melihat daftar dan menemukan komponen tambahan yang Anda inginkan.

sdkmanager --list

Jenis komponen berikut berguna untuk diketahui:

  • platforms;android-XX: Menginstal platform android-XX ke dalam sdk. Ganti XX dengan API Level platform yang Anda pilih. Misalnya platforms;android-30 akan menginstal Android API 30, sementara platforms;android-21 akan menginstal Android API 21.

  • system-images;android-XX;default;x86_64: Menginstal gambar emulator untuk tingkat API tertentu. x86_64 dapat ditukar dengan ARI yang berbeda seperti x86, arm64-v8a, dan x86_64. Ini mencerminkan ABI gambar yang diinstal. Ini dapat berguna jika Anda memiliki masalah pada ABI tertentu.

Ini juga merupakan praktik yang baik untuk mengatur ANDROID_HOME variabel lingkungan, karena ini memungkinkan Anda untuk menggunakan alat tertentu dari baris perintah.