Memasangkan ke Mac untuk pengembangan Xamarin.iOS
Panduan ini menjelaskan cara menggunakan Pair to Mac untuk menyambungkan Visual Studio 2019 ke host build Mac. Instruksi yang sama berlaku untuk Visual Studio 2017.
Gambaran Umum
Membangun aplikasi iOS asli memerlukan akses ke alat build Apple, yang hanya berjalan di Mac. Karena itu, Visual Studio 2019 harus terhubung ke Mac yang dapat diakses jaringan untuk membangun aplikasi Xamarin.iOS.
Fitur Pair to Mac Visual Studio 2019 menemukan, menyambungkan, mengautentikasi dengan, dan mengingat host build Mac sehingga pengembang iOS berbasis Windows dapat bekerja secara produktif.
Memasangkan ke Mac memungkinkan alur kerja pengembangan berikut:
Pengembang dapat menulis kode Xamarin.iOS di Visual Studio 2019.
Visual Studio 2019 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 2019 memanggil build Mac dengan aman melalui SSH.
Visual Studio 2019 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 2019 dapat terhubung ke Mac secara bersamaan.
Anda dapat menggunakan baris perintah Windows untuk membangun aplikasi iOS.
Catatan
Sebelum mengikuti instruksi dalam panduan ini, selesaikan langkah-langkah berikut:
- Pada komputer Windows, instal Visual Studio 2019
- Di Mac, instal Xcode dan Visual Studio untuk Mac
- Anda harus membuka Xcode secara manual setelah menginstal sehingga dapat menambahkan komponen tambahan apa pun.
Jika Anda lebih suka tidak menginstal Visual Studio untuk Mac, Visual Studio 2019 dapat secara otomatis mengonfigurasi host build Mac dengan Xamarin.iOS dan Mono. Anda masih harus menginstal dan menjalankan Xcode. Untuk informasi selengkapnya, lihat Provisi Mac otomatis.
Mengaktifkan masuk jarak jauh di Mac
Untuk mengatur host build Mac, pertama-tama aktifkan masuk jarak jauh:
Di Mac, buka Preferensi Sistem dan buka panel Berbagi .
Periksa Masuk Jarak Jauh di daftar Layanan .
Pastikan dikonfigurasi untuk mengizinkan akses bagi Semua pengguna, atau bahwa nama pengguna atau grup Mac Anda disertakan dalam daftar pengguna yang diizinkan.
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 ini masalahnya.Jika berada di jaringan yang sama dengan komputer Windows, Mac sekarang harus dapat ditemukan oleh Visual Studio 2019. Jika Mac masih belum dapat ditemukan, coba tambahkan Mac secara manual atau lihat panduan pemecahan masalah.
Koneksi ke Mac dari Visual Studio 2019
Sekarang setelah login jarak jauh diaktifkan, sambungkan Visual Studio 2019 ke Mac.
Di Visual Studio 2019, buka proyek iOS yang sudah ada atau buat proyek baru dengan memilih File > Proyek Baru > lalu pilih templat proyek iOS.
Buka dialog Pasangkan ke Mac .
Gunakan toolbar iOS tombol Pasangkan ke Mac :
Atau, pilih Alat > iOS > Pair ke Mac.
Dialog Pasangkan ke Mac menampilkan daftar semua host build Mac yang terhubung sebelumnya dan yang saat ini tersedia:
Pilih Mac dalam daftar. Klik Sambungkan.
Masukkan nama pengguna dan sandi Anda.
Pertama kali Anda terhubung ke Mac tertentu, Anda diminta untuk memasukkan nama pengguna dan kata sandi Untuk komputer tersebut:
Tip
Saat masuk, gunakan nama pengguna sistem Anda daripada nama lengkap.
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.
Memasangkan ke Mac secara otomatis mengonfigurasi Mac.
Dimulai dengan Visual Studio 2019 versi 15.6, Visual Studio 2019 menginstal atau memperbarui Mono dan Xamarin.iOS pada host build Mac yang terhubung sesuai kebutuhan (perhatikan bahwa Xcode masih harus diinstal secara manual). Lihat Provisi Mac Otomatis untuk detail selengkapnya.
Cari ikon status koneksi.
Saat Visual Studio 2019 tersambung ke Mac, item Mac tersebut dalam dialog Pasangkan ke Mac menampilkan ikon yang menunjukkan bahwa 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 Koneksi..., 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 berhasil dipasangkan ke host build Mac, Anda siap untuk membuat aplikasi Xamarin.iOS di Visual Studio 2019. Lihat panduan Pengenalan Xamarin.iOS untuk Visual Studio.
Jika Anda belum dapat memasangkan Mac, coba tambahkan Mac secara manual atau lihat panduan pemecahan masalah.
Menambahkan Mac secara manual
Jika Anda tidak melihat Mac tertentu yang tercantum dalam dialog Pasangkan ke Mac , tambahkan secara manual:
Temukan alamat IP Mac Anda.
Dalam dialog Pasangan Visual Studio 2019 ke Mac , pilih Tambahkan Mac...:
Masukkan alamat IP Mac dan klik Tambahkan:
Masukkan nama pengguna dan kata sandi Anda untuk Mac:
Tip
Saat masuk, gunakan nama pengguna sistem Anda daripada nama lengkap.
Klik Masuk untuk menyambungkan Visual Studio 2019 ke Mac melalui SSH dan tambahkan ke daftar komputer yang diketahui.
Provisi Mac otomatis
Dimulai dengan Visual Studio 2019 versi 15.6, Memasangkan ke Mac secara otomatis menyediakan Mac dengan perangkat lunak yang diperlukan untuk membangun aplikasi Xamarin.iOS: Mono, Xamarin.iOS (kerangka kerja perangkat lunak, bukan Visual Studio untuk Mac IDE), dan berbagai alat terkait Xcode (tetapi bukan Xcode itu sendiri).
Penting
- Pasangan ke Mac tidak dapat menginstal Xcode; Anda harus menginstalnya secara manual di host build Mac. Hal ini diperlukan untuk pengembangan Xamarin.iOS.
- Provisi Mac otomatis mengharuskan login jarak jauh diaktifkan di Mac, dan Mac harus dapat diakses jaringan ke komputer Windows. Lihat Mengaktifkan masuk jarak jauh di Mac untuk detail selengkapnya.
- Provisi Mac otomatis memerlukan ruang kosong 3GB di Mac untuk menginstal Xamarin.iOS.
Memasangkan ke Mac melakukan penginstalan/pembaruan perangkat lunak yang diperlukan saat Visual Studio 2019 tersambung ke Mac.
Mono
Pasangkan ke Mac akan memeriksa untuk memastikan bahwa Mono diinstal. Jika tidak diinstal, Pasangkan ke Mac akan mengunduh dan menginstal mono versi stabil terbaru di Mac.
Kemajuan ditunjukkan oleh berbagai perintah, seperti yang ditunjukkan oleh cuplikan layar berikut (klik untuk memperbesar):
Mono | Periksa Penginstalan | Mengunduh | Menginstal |
---|---|---|---|
Xamarin.iOS
Memasangkan ke Mac meningkatkan Xamarin.iOS di Mac agar sesuai dengan versi yang diinstal pada komputer Windows.
Penting
Memasangkan ke Mac tidak akan menurunkan versi Xamarin.iOS di Mac dari alfa/beta ke stabil. Jika Anda telah menginstal Visual Studio untuk Mac, atur saluran rilis Anda sebagai berikut:
- Jika Anda menggunakan Visual Studio 2019, pilih saluran Pembaruan stabil di Visual Studio untuk Mac.
- Jika Anda menggunakan Pratinjau Visual Studio 2019, pilih saluran pembaruan Alpha di Visual Studio untuk Mac.
Kemajuan ditunjukkan oleh berbagai perintah, seperti yang ditunjukkan oleh cuplikan layar berikut (klik untuk memperbesar):
Xamarin.iOS | Periksa Penginstalan | Mengunduh | Menginstal |
---|---|---|---|
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, seperti yang ditunjukkan pada cuplikan layar berikut (klik untuk memperbesar):
Xcode | Periksa Penginstalan | Penerimaan Lisensi |
---|---|---|
Selain itu, Pasangkan ke Mac akan menginstal atau memperbarui berbagai paket yang didistribusikan dengan Xcode. Contohnya:
- MobileDeviceDevelopment.pkg
- XcodeExtensionSupport.pkg
- MobileDevice.pkg
- XcodeSystemResources.pkg
Penginstalan paket ini terjadi dengan cepat dan tanpa perintah.
Catatan
Alat-alat ini berbeda dari Xcode Command Line Tools, yang pada macOS 10.9 diinstal dengan Xcode.
Pemecahan masalah provisi Mac otomatis
Jika Anda mengalami masalah saat menggunakan provisi Mac otomatis, lihat log IDE Visual Studio 2019, yang disimpan di %LOCALAPPDATA%\Xamarin\Logs\16.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
Pair to Mac mendukung pembuatan aplikasi Xamarin.iOS dari baris perintah. Contohnya:
C:\samples\App1>msbuild App1.sln /p:ServerAddress=10.211.55.2 /p:ServerUser=xamUser /p:Platform=iPhoneSimulator /p:ServerPassword=mypassword
Parameter yang diteruskan ke msbuild
dalam contoh di atas adalah:
ServerAddress
– Alamat IP host build Mac.ServerUser
– Nama pengguna yang 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.
Catatan
Visual Studio 2019 disimpan msbuild
di direktori berikut: C:\Program Files (x86)\Microsoft Visual Studio\2019\<Version>\MSBuild\Current\Bin
Pertama kali Pair to Mac masuk ke host build Mac tertentu dari Visual Studio 2019 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.
Ringkasan
Artikel ini menjelaskan cara menggunakan Pair to Mac untuk menyambungkan Visual Studio 2019 ke host build Mac, memungkinkan pengembang Visual Studio 2019 untuk membangun aplikasi iOS asli dengan Xamarin.iOS.