Bagikan melalui

Memasangkan ke Mac untuk pengembangan Xamarin.iOS

  • Artikel

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:

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:

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

  2. Periksa Masuk Jarak Jauh di daftar Layanan .

    Enabling Remote Login

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

  3. 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.

  4. 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.

  1. Di Visual Studio 2019, buka proyek iOS yang sudah ada atau buat proyek baru dengan memilih File > Proyek Baru > lalu pilih templat proyek iOS.

  2. Buka dialog Pasangkan ke Mac .

    • Gunakan toolbar iOS tombol Pasangkan ke Mac :

      The iOS toolbar, with the Pair to Mac button highlighted

    • 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:

      The Pair to Mac dialog

  3. Pilih Mac dalam daftar. Klik Sambungkan.

  4. 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:

      Entering a username and password for the Mac

      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.

  5. 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.

  6. 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:

      A connected Mac

      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:

      The Pair to Mac context menus

      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:

  1. Temukan alamat IP Mac Anda.

    • Buka Preferensi Sistem Yang > Berbagi > Login Jarak Jauh di Mac Anda:

      The Mac's IP address in System Preferences > Sharing

    • Atau, gunakan baris perintah. Di Terminal, terbitkan perintah ini:

      $ ipconfig getifaddr en0
196.168.1.8

      Bergantung pada konfigurasi jaringan Anda, Anda mungkin perlu menggunakan nama antarmuka selain en0. Misalnya: en1, , en2dll.

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

    The Add Mac button in the Pair to Mac dialog

  3. Masukkan alamat IP Mac dan klik Tambahkan:

    Entering the Mac's IP address

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

    Enter a username and password

    Tip

    Saat masuk, gunakan nama pengguna sistem Anda daripada nama lengkap.

  5. 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
Missing Mono installation Downloading Mono Installing Mono

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
Missing Xamarin.iOS installation Downloading Xamarin.iOS Installing Xamarin.iOS

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
Missing Xcode installation Xcode license

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.

Langkah berikutnya