Memasangkan ke Mac untuk pengembangan iOS

Membangun aplikasi iOS asli menggunakan .NET Multi-platform App UI (.NET MAUI) memerlukan akses ke alat build Apple, yang hanya berjalan di Mac. Karena itu, Visual Studio 2022 harus terhubung ke Mac yang dapat diakses jaringan untuk membangun aplikasi .NET MAUI iOS.

Fitur Pair to Mac Visual Studio 2022 menemukan, menyambungkan, mengautentikasi dengan, dan mengingat host build Mac sehingga Anda dapat bekerja secara produktif di Windows.

Memasangkan ke Mac memungkinkan alur kerja pengembangan perangkat lunak berikut:

• Anda dapat menulis kode .NET MAUI iOS di Visual Studio 2022.
• Visual Studio 2022 membuka koneksi jaringan ke host build Mac dan menggunakan alat build di komputer tersebut untuk mengkompilasi dan menandatangani aplikasi iOS.
• Tidak perlu menjalankan aplikasi terpisah di Mac – Visual Studio 2022 memanggil build Mac dengan aman melalui SSH.
• Visual Studio 2022 diberi tahu tentang perubahan segera setelah terjadi. Misalnya, saat perangkat iOS dicolokkan ke Mac atau tersedia di jaringan, Toolbar iOS akan langsung diperbarui.
• Beberapa instans Visual Studio 2022 dapat terhubung ke Mac secara bersamaan.
• Anda dapat menggunakan baris perintah Windows untuk membangun aplikasi iOS.

Mengaktifkan masuk jarak jauh di Mac

Untuk mengatur host build Mac, pertama-tama aktifkan masuk jarak jauh:

1. Di Mac, buka Preferensi Sistem dan buka panel Berbagi .

2. Aktifkan Masuk Jarak Jauh di daftar Tingkat Lanjut.

   

3. Klik i di samping pengaturan Masuk Jarak Jauh untuk mengonfigurasi pengaturan lainnya:

   • Aktifkan Izinkan akses disk penuh untuk pengguna jarak jauh.

   • Pastikan bahwa masuk jarak jauh dikonfigurasi untuk mengizinkan akses bagi Semua pengguna, atau bahwa nama pengguna atau grup Mac Anda disertakan dalam daftar pengguna yang diizinkan.

   

4. Jika diminta, konfigurasikan firewall macOS. Jika Anda telah mengatur firewall macOS untuk memblokir koneksi masuk, Anda mungkin perlu mengizinkan mono-sgen untuk menerima koneksi masuk. Pemberitahuan tampaknya meminta Anda jika demikian.

5. Jika berada di jaringan yang sama dengan komputer Windows, Mac sekarang harus dapat ditemukan oleh Visual Studio 2022. Jika Mac masih belum dapat ditemukan, coba tambahkan Mac secara manual.

Menyambungkan ke Mac dari Visual Studio 2022

Setelah mengaktifkan masuk jarak jauh di Mac, sambungkan Visual Studio 2022 ke Mac:

1. Di Visual Studio 2022, buka proyek .NET MAUI yang sudah ada atau buat yang baru.

2. Buka dialog Pasangkan ke Mac dengan toolbar iOS tombol Pasang ke Mac :

   

   Atau, pilih >.

   Dialog Pasangkan ke Mac menampilkan daftar semua host build Mac yang terhubung sebelumnya dan saat ini tersedia:

   

3. Pilih Mac dalam daftar dan pilih Sambungkan.

4. Masukkan nama pengguna dan sandi Anda. Saat pertama kali terhubung ke Mac tertentu, Anda diminta untuk memasukkan nama pengguna dan kata sandi untuk komputer tersebut:

   

   Tip

   Saat masuk, gunakan nama pengguna sistem Anda.

   Memasangkan ke Mac menggunakan kredensial ini untuk membuat koneksi SSH baru ke Mac. Jika berhasil, kunci ditambahkan ke file authorized_keys di Mac. Koneksi berikutnya ke Mac yang sama akan masuk secara otomatis.

5. Memasangkan ke Mac secara otomatis mengonfigurasi Mac. Visual Studio 2022 menginstal atau memperbarui prasyarat pada host build Mac yang terhubung sesuai kebutuhan. Namun, Xcode masih harus diinstal secara manual.

6. Periksa ikon status koneksi. Saat Visual Studio 2022 tersambung ke Mac, item Mac tersebut dalam dialog Pasangkan ke Mac menampilkan ikon yang menunjukkan bahwa item saat ini tersambung:

   

   Hanya ada satu Mac yang terhubung pada satu waktu.

   Tip

   Mengklik kanan Mac apa pun di daftar Pasangkan ke Mac memunculkan menu konteks yang memungkinkan Anda menyambungkan ..., Lupakan Mac ini, atau Putuskan sambungan:

   

   Jika Anda memilih Lupakan Mac ini, kredensial Anda untuk Mac yang dipilih akan dilupakan. Untuk menyambungkan kembali ke Mac tersebut, Anda harus memasukkan ulang nama pengguna dan kata sandi Anda.

Jika Anda berhasil memasangkan ke host build Mac, Anda siap untuk membuat aplikasi .NET MAUI iOS di Visual Studio 2022. Untuk informasi selengkapnya, lihat Membangun aplikasi pertama Anda.

Jika Anda belum dapat memasangkan Mac, coba tambahkan Mac secara manual.

Menambahkan Mac secara manual

Jika Anda tidak melihat Mac tertentu yang tercantum dalam dialog Pasangkan ke Mac , tambahkan secara manual:

1. Buka Preferensi Sistem Berbagi >> Masuk Jarak Jauh di Mac Anda untuk menemukan alamat IP Mac Anda:

   

   Atau, gunakan baris perintah. Di Terminal, terbitkan perintah berikut:

   ipconfig getifaddr en0
   

   Bergantung pada konfigurasi jaringan, Anda mungkin perlu menggunakan nama antarmuka selain en0, misalnya, en1 atau en2.

2. Dalam dialog Pasangan Visual Studio 2022 ke Mac , pilih Tambahkan Mac...:

   

3. Masukkan alamat IP Mac dan pilih Tambahkan:

   

4. Masukkan nama pengguna dan kata sandi Anda untuk Mac:

   

   Tip

   Saat masuk, gunakan nama pengguna sistem Anda.

5. Pilih Masuk untuk menyambungkan Visual Studio 2022 ke Mac melalui SSH dan tambahkan ke daftar komputer yang diketahui.

Mengaktifkan koneksi otomatis ke Mac yang diketahui

Secara default, koneksi ke Mac yang dipasangkan sebelumnya tidak akan dibuat saat Visual Studio dimulai. Namun, koneksi otomatis ke Mac yang diketahui dapat diaktifkan di Visual Studio dengan menavigasi ke Opsi Alat > Xamarin >> Pengaturan iOS dan memastikan bahwa Aktifkan koneksi otomatis ke Mac yang diketahui dicentang:

Setelah menghidupkan ulang Visual Studio, Visual Studio akan secara otomatis terhubung ke Mac yang diketahui pada setiap peluncuran.

Provisi Mac otomatis

Memasangkan ke Mac secara otomatis menyediakan Mac dengan perangkat lunak yang diperlukan untuk membangun aplikasi .NET MAUI iOS. Ini termasuk .NET dan berbagai alat terkait Xcode (tetapi tidak Xcode itu sendiri).

Selain itu, Pair to Mac melakukan penginstalan dan pembaruan perangkat lunak yang diperlukan ke Mac, saat Visual Studio 2022 tersambung ke Mac.

Alat dan lisensi Xcode

Pasangkan ke Mac juga akan memeriksa untuk menentukan apakah Xcode telah diinstal dan lisensinya diterima. Meskipun Pair to Mac tidak menginstal Xcode, itu meminta penerimaan lisensi.

Selain itu, Pasangkan ke Mac akan menginstal atau memperbarui berbagai paket yang didistribusikan dengan Xcode. Penginstalan paket ini terjadi dengan cepat dan tanpa perintah.

Pemecahan masalah provisi Mac otomatis

Jika Anda mengalami masalah saat menggunakan provisi Mac otomatis, lihat log IDE Visual Studio 2022, yang disimpan di %LOCALAPPDATA%\Xamarin\Logs\17.0. Log ini mungkin berisi pesan kesalahan untuk membantu Anda mendiagnosis kegagalan dengan lebih baik atau mendapatkan dukungan.

Membangun aplikasi iOS dari baris perintah Windows

Memasangkan ke Mac mendukung pembuatan aplikasi .NET MAUI dari baris perintah. Navigasi ke folder yang menyimpan sumber aplikasi .NET MAUI iOS Anda dan jalankan perintah berikut:

dotnet build -f net8.0-ios -p:ServerAddress={macOS build host IP address} -p:ServerUser={macOS username} -p:ServerPassword={macOS password} -p:TcpPort=58181 -p:_DotNetRootRemoteDirectory=/Users/{macOS username}/Library/Caches/Xamarin/XMA/SDKs/dotnet/

Parameter yang diteruskan ke dotnet dalam contoh di atas adalah:

• ServerAddress – alamat IP host build Mac.
• ServerUser – nama pengguna yang akan digunakan saat masuk ke host build Mac. Gunakan nama pengguna sistem Anda daripada nama lengkap Anda.
• ServerPassword – kata sandi yang digunakan saat masuk ke host build Mac.
• _DotNetRootRemoteDirectory - folder pada host build Mac yang berisi .NET SDK.

Pertama kali Pair to Mac masuk ke host build Mac dari Visual Studio 2022 atau baris perintah, ia mengatur kunci SSH. Dengan kunci ini, login di masa mendatang tidak akan memerlukan nama pengguna atau kata sandi. Kunci yang baru dibuat disimpan di %LOCALAPPDATA%\Xamarin\MonoTouch.

ServerPassword Jika parameter dihilangkan dari pemanggilan build baris perintah, Pasangkan ke Mac mencoba masuk ke host build Mac menggunakan kunci SSH yang disimpan.

Untuk informasi selengkapnya tentang membuat aplikasi iOS dari baris perintah Windows, lihat Menerbitkan aplikasi iOS menggunakan baris perintah.