Bagikan melalui

Membuat aplikasi iOS dengan .NET CLI

  • Artikel

Dalam tutorial ini, Anda akan mempelajari cara membuat dan menjalankan aplikasi .NET Multi-platform App UI (.NET MAUI) di iOS menggunakan .NET Command Line Interface (CLI) di macOS:

  1. Untuk membuat aplikasi .NET MAUI, Anda harus mengunduh dan menjalankan alat penginstal untuk runtime .NET terbaru. Anda juga harus mengunduh dan menginstal versi Xcode yang diperlukan oleh versi .NET MAUI yang Anda gunakan. Untuk informasi, lihat Versi rilis.

  2. Di Mac Anda, buka Terminal dan periksa apakah Anda memiliki runtime .NET terbaru yang terinstal:

    dotnet --version

  3. Di Terminal, instal build publik terbaru .NET MAUI:

    sudo dotnet workload install maui --source https://api.nuget.org/v3/index.json

    Perintah ini akan menginstal versi terbaru .NET MAUI yang dirilis, termasuk SDK platform yang diperlukan.

  4. Di Terminal, buat aplikasi MAUI .NET baru menggunakan .NET CLI:

    dotnet new maui -n "MyMauiApp"

  1. Di Terminal, ubah direktori ke MyMauiApp, dan buat dan jalankan aplikasi:

    cd MyMauiApp
dotnet build -t:Run -f net8.0-ios

    Perintah dotnet build akan memulihkan proyek dependensi, membangun aplikasi, dan meluncurkannya di simulator default.

  2. Di simulator default, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah.

    Aplikasi .NET MAUI yang berjalan di simulator iOS default.

Bangun dengan versi Xcode tertentu

Jika Anda memiliki beberapa versi Xcode yang terinstal di Mac, Anda dapat menentukan versi Xcode mana yang harus digunakan saat membuat aplikasi. Ada sejumlah pendekatan yang dapat digunakan untuk mencapai hal ini, tetapi pendekatan yang direkomendasikan adalah mengatur MD_APPLE_SDK_ROOT variabel lingkungan ke jalur versi Xcode.

Peringatan

Menggunakan xcode-select -s untuk mengatur versi Xcode yang akan digunakan tidak disarankan.

Untuk mengatur MD_APPLE_SDK_ROOT variabel lingkungan selama durasi sesi terminal saat ini:

  1. Buka aplikasi Terminal.

  2. Ketik perintah berikut, ganti di versi Xcode Anda, dan tekan Enter:

    export MD_APPLE_SDK_ROOT=/Applications/Xcode_14.1.0.app

Jika Anda ingin mengatur variabel lingkungan ini secara permanen, Anda dapat menambahkan export perintah ke profil shell Anda, seperti .zprofile.

Luncurkan aplikasi pada simulator tertentu

Aplikasi .NET MAUI iOS dapat diluncurkan pada simulator iOS tertentu dari Mac dengan memberikan id perangkat uniknya (UDID):

  1. Di Mac Anda, buka Xcode, pilih item menu Perangkat Windows > dan Simulator, lalu tab Simulator .

    Cuplikan layar tab simulator Xcode.

  2. Klik kanan pada simulator yang Anda pilih, dan pilih Salin Pengidentifikasi untuk menyalin UDID ke clipboard.

    Cuplikan layar opsi menu pengidentifikasi salin di Xcode.

    Atau, Anda dapat mengambil daftar nilai UDID dengan menjalankan simctl list perintah:

    /Applications/Xcode.app/Contents/Developer/usr/bin/simctl list

  1. Di Terminal, buat aplikasi dan jalankan pada simulator yang Anda pilih dengan menentukan _DeviceName properti MSBuild menggunakan -p opsi MSBuild:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=MY_SPECIFIC_UDID

    Misalnya, gunakan perintah berikut untuk membangun aplikasi dan menjalankannya di simulator iPhone 13 Pro:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=E25BBE37-69BA-4720-B6FD-D54C97791E79

  2. Di simulator yang Anda pilih, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah.

    Aplikasi .NET MAUI berjalan di simulator iPhone 13 Pro.

Meluncurkan aplikasi di perangkat

Perangkat harus disediakan sebelum Anda dapat menyebarkan aplikasi iOS ke perangkat tersebut. Untuk informasi selengkapnya, lihat Provisi perangkat untuk iOS. Setelah perangkat disediakan, aplikasi .NET MAUI iOS dapat diluncurkan pada perangkat dari Mac dengan memberikan id perangkat uniknya (UDID):

  1. Sambungkan perangkat Anda ke Mac lokal Anda dengan kabel USB.

  2. Buka Xcode, dan navigasikan ke Perangkat Jendela > dan Simulator.

  3. Di Xcode, pilih tab Perangkat , dan pilih perangkat dari daftar perangkat yang terhubung.

  4. Di Xcode, salin nilai Pengidentifikasi ke clipboard:

    Perangkat Xcode dan jendela simulator dengan lokasi string pengidentifikasi iOS disorot.

    Atau, klik kanan pada perangkat Anda dan pilih Salin Pengidentifikasi untuk menyalin UDID ke clipboard.

  1. Di Terminal, buat aplikasi dan jalankan di perangkat yang Anda pilih dengan menentukan _DeviceName properti MSBuild menggunakan -p opsi MSBuild:

    dotnet build -t:Run -f net8.0-ios -p:RuntimeIdentifier=ios-arm64 -p:_DeviceName=MY_SPECIFIC_UDID

    Ganti "MY_SPECIFIC_UDID" dengan pengidentifikasi perangkat yang Anda salin ke clipboard.