Durchführen einer Kopplung mit einem Mac für die Xamarin.iOS-EntwicklungPair to Mac for Xamarin.iOS development

In diesem Leitfaden wird erläutert, wie Sie die Option „Mit Mac koppeln“ verwenden, um Visual Studio 2019 mit einem Mac-Buildhost zu verbinden. Diese Anweisungen gelten auch für Visual Studio 2017.This guide describes how to use Pair to Mac to connect Visual Studio 2019 to a Mac build host. The same instructions apply to Visual Studio 2017.

ÜbersichtOverview

Zum Erstellen nativer iOS-Anwendungen sind die Apple-Buildtools erforderlich, die nur auf einem Mac ausgeführt werden können.Building native iOS applications requires access to Apple's build tools, which only run on a Mac. Aus diesem Grund muss Visual Studio 2019 eine Verbindung zu einem Mac herstellen, der über ein Netzwerk zugänglich ist, da andernfalls keine Xamarin.iOS-Anwendungen erstellt werden können.Because of this, Visual Studio 2019 must connect to a network-accessible Mac to build Xamarin.iOS applications.

Durch das Visual Studio 2019-Feature „Mit Mac koppeln“ werden zuerst Mac-Buildhosts ermittelt. Anschließend wird eine Verbindung mit diesen hergestellt, die Authentifizierung wird vorgenommen, und die Buildhosts werden gespeichert. Hierdurch können iOS-Entwickler unter Windows produktiv arbeiten.Visual Studio 2019's Pair to Mac feature discovers, connects to, authenticates with, and remembers Mac build hosts so that Windows-based iOS developers can work productively.

Das Feature „Mit Mac koppeln“ ermöglicht den folgenden Entwicklungsworkflow:Pair to Mac enables the following development workflow:

  • Entwickler können in Visual Studio 2019 Xamarin.iOS-Code schreiben.Developers can write Xamarin.iOS code in Visual Studio 2019.

  • Visual Studio 2019 stellt eine Netzwerkverbindung mit einem Mac-Buildhost her und verwendet die Buildtools auf diesem Computer, um die iOS-App zu kompilieren und zu signieren.Visual Studio 2019 opens a network connection to a Mac build host and uses the build tools on that machine to compile and sign the iOS app.

  • Auf dem Mac muss keine separate Anwendung ausgeführt werden, da Visual Studio 2019 die Mac-Builds über eine sichere SSH-Verbindung aufruft.There is no need to run a separate application on the Mac – Visual Studio 2019 invokes Mac builds securely over SSH.

  • Visual Studio 2019 wird unmittelbar über Änderungen informiert.Visual Studio 2019 is notified of changes as soon as they happen. Wenn beispielsweise ein iOS-Gerät an den Mac angeschlossen oder ein Gerät im Netzwerk verfügbar wird, wird die iOS-Symbolleiste sofort aktualisiert.For example, when an iOS device is plugged in to the Mac or becomes available on the network, the iOS Toolbar updates instantly.

  • Mehrere Instanzen von Visual Studio 2019 können gleichzeitig eine Verbindung mit dem Mac herstellen.Multiple instances of Visual Studio 2019 can connect to the Mac simultaneously.

  • Die Windows-Befehlszeile kann zur Erstellung von iOS-Anwendungen verwendet werden.It's possible to use the Windows command-line to build iOS applications.

Hinweis

Führen Sie zunächst die folgenden Schritte aus, bevor Sie die Anweisungen in diesem Leitfaden beachten:Before following the instructions in this guide, complete the following steps:

Wenn Sie Visual Studio für Mac nicht installieren möchten, kann Visual Studio 2019 automatisch den Mac-Buildhost mit Xamarin.iOS und Mono konfigurieren.If you would prefer not to install Visual Studio for Mac, Visual Studio 2019 can automatically configure the Mac build host with Xamarin.iOS and Mono. Sie müssen noch Xcode installieren und ausführen.You must still install and run Xcode. Weitere Informationen finden Sie unter Automatische Bereitstellung eines Macs.For more information, see Automatic Mac provisioning.

Aktivieren der Remoteanmeldung auf dem MacEnable remote login on the Mac

Aktivieren Sie zur Einrichtung des Mac-Buildhosts zunächst die Remoteanmeldung:To set up the Mac build host, first enable remote login:

  1. Rufen Sie auf dem Mac die Systemeinstellungen auf, und navigieren Sie zum Bereich Freigaben.On the Mac, open System Preferences and go to the Sharing pane.

  2. Aktivieren Sie in der Liste Dienst das Kontrollkästchen Entfernte Anmeldung.Check Remote Login in the Service list.

    „Entfernte Anmeldung“ aktivierenEnabling Remote Login

    Stellen Sie sicher, dass für diese Option die Zugriffseinstellung Alle Benutzer festgelegt ist oder dass Ihr Mac-Benutzername oder Ihre Mac-Gruppe in der Liste der zugelassenen Benutzer enthalten ist.Make sure that it is configured to allow access for All users, or that your Mac username or group is included in the list of allowed users.

  3. Konfigurieren Sie die macOS-Firewall, wenn Sie dazu aufgefordert werden.If prompted, configure the macOS firewall.

    Falls Sie Ihre macOS-Firewall so konfiguriert haben, dass eingehende Verbindungen blockiert werden, sollten Sie für mono-sgen den Empfang eingehender Verbindungen zulassen.If you have set the macOS firewall to block incoming connections, you may need to allow mono-sgen to receive incoming connections. In diesem Fall werden Sie durch eine Benachrichtigung dazu aufgefordert.An alert appears to prompt you if this is the case.

  4. Ihr Mac sollte nun von Visual Studio 2019 erkannt werden, wenn dieser sich in demselben Netzwerk wie der Windows-Computer befindet.If it is on the same network as the Windows machine, the Mac should now be discoverable by Visual Studio 2019. Wenn der Mac immer noch nicht erkannt wird, können Sie versuchen, diesen manuell hinzuzufügen. Alternativ können Sie sich auch den Leitfaden zur Problembehebung ansehen.If the Mac is still not discoverable, try manually adding a Mac or take a look at the troubleshooting guide.

Herstellen einer Verbindung mit dem Mac über Visual Studio 2019Connect to the Mac from Visual Studio 2019

Nachdem Sie die Remoteanmeldung aktiviert haben, können Sie Visual Studio 2019 mit dem Mac verbinden.Now that remote login is enabled, connect Visual Studio 2019 to the Mac.

  1. Öffnen Sie in Visual Studio 2019 ein vorhandenes iOS-Projekt, oder erstellen Sie über Datei > Neu > Projekt ein neues, und wählen Sie anschließend eine iOS-Projektvorlage aus.In Visual Studio 2019, open an existing iOS project or create a new one by choosing File > New > Project and then selecting an iOS project template.

  2. Öffnen Sie das Dialogfeld Mit Mac koppeln.Open the Pair to Mac dialog.

    • Klicken Sie dazu auf die Schaltfläche Mit Mac koppeln in der iOS-Symbolleiste:Use the Pair to Mac button iOS toolbar:

      Die iOS-Symbolleiste mit hervorgehobener Schaltfläche „Mit Mac koppeln“The iOS toolbar, with the Pair to Mac button highlighted

    • Alternativ können Sie auch Extras > iOS > Mit Mac koppeln aufrufen.Or, select Tools > iOS > Pair to Mac.

    • Im Dialogfeld Mit Mac koppeln wird eine Liste aller zuvor verbundenen und zurzeit verfügbaren Mac-Buildhosts angezeigt:The Pair to Mac dialog displays a list of all previously-connected and currently-available Mac build hosts:

      Das Dialogfeld „Mit Mac koppeln“The Pair to Mac dialog

  3. Wählen Sie einen Mac aus der Liste aus.Select a Mac in the list. Klicken Sie auf Verbinden.Click Connect.

  4. Geben Sie Ihren Benutzernamen und Ihr Kennwort ein.Enter your username and password.

    • Beim erstmaligen Herstellen einer Verbindung mit einem Mac werden Sie aufgefordert, Ihren Benutzernamen und Ihr Kennwort für diesen Computer einzugeben:The first time you connect to any particular Mac, you are prompted to enter your username and password for that machine:

      Einen Benutzernamen und ein Kennwort für den Mac eingebenEntering a username and password for the Mac

      Tipp

      Verwenden Sie bei der Anmeldung Ihren Systembenutzernamen anstelle des vollständigen Namens.When logging in, use your system username rather than full name.

    • Die Anmeldeinformationen werden vom Feature „Mit Mac koppeln“ verwendet, um eine neue SSH-Verbindung mit dem Mac herzustellen.Pair to Mac uses these credentials to create a new SSH connection to the Mac. Wenn dieser Vorgang erfolgreich ist, wird der Datei authorized_keys auf dem Mac ein Schlüssel hinzugefügt.If it succeeds, a key is added to the authorized_keys file on the Mac. Bei allen weiteren Verbindungen mit demselben Mac wird die Anmeldung automatisch vorgenommen.Subsequent connections to the same Mac will login automatically.

  5. Das Feature „Mit Mac koppeln“ konfiguriert den Mac automatisch.Pair to Mac automatically configures the Mac.

    Ab der Version 15.6 von Visual Studio 2019 werden Mono und Xamarin.iOS auf einem verbundenen Mac-Buildhost bei Bedarf installiert oder aktualisiert. Beachten Sie, dass Xcode nach wie vor manuell installiert werden muss.Starting with Visual Studio 2019 version 15.6, Visual Studio 2019 installs or updates Mono and Xamarin.iOS on a connected Mac build host as needed (note that Xcode must still be installed manually). Weitere Informationen finden Sie unter Automatische Bereitstellung eines Macs.See Automatic Mac provisioning for more details.

  6. Suchen Sie nach dem Symbol für den Verbindungsstatus.Look for the connection status icon.

    • Wenn Visual Studio 2019 mit einem Mac verbunden wird, wird für das Mac-Element im Dialogfeld Mit Mac koppeln ein Symbol angezeigt, das darauf hinweist, dass aktuell eine Verbindung besteht:When Visual Studio 2019 is connected to a Mac, that Mac's item in the Pair to Mac dialog displays an icon indicating that it is currently connected:

      Ein verbundener MacA connected Mac

      Es kann immer nur ein Mac gleichzeitig verbunden sein.There can be only one connected Mac at a time.

      Tipp

      Wenn Sie mit der rechten Maustaste auf einen Mac in der Liste Mit Mac koppeln klicken, wird ein Kontextmenü angezeigt, in dem Sie die Aktion Verbinden... , Diesen Mac vergessen oder Verbindung trennen ausführen können.Right-clicking any Mac in the Pair to Mac list brings up a context menu that allows you to Connect..., Forget this Mac, or Disconnect:

      Die von „Mit Mac koppeln“ aufgerufenen KontextmenüsThe Pair to Mac context menus

      Falls Sie auf Diesen Mac vergessen klicken, werden die Anmeldeinformationen für den ausgewählten Mac verworfen.If you choose Forget this Mac, your credentials for the selected Mac will be forgotten. Wenn Sie erneut eine Verbindung mit diesem Mac herstellen möchten, müssen Sie Ihren Benutzernamen und Ihr Kennwort erneut eingeben.To reconnect to that Mac, you will need to re-enter your username and password.

Sobald Sie eine Kopplung mit dem Mac-Buildhost erfolgreich durchgeführt haben, können Sie Xamarin.iOS-Apps in Visual Studio 2019 erstellen.If you have successfully paired to a Mac build host, you are ready to build Xamarin.iOS apps in Visual Studio 2019. Informationen hierzu finden Sie im Leitfaden Einführung in Xamarin.iOS für Visual Studio.Take a look at the Introduction to Xamarin.iOS for Visual Studio guide.

Wenn die Kopplung fehlschlägt, können Sie versuchen, den Mac manuell hinzuzufügen. Alternativ können Sie sich auch den Leitfaden zur Problembehebung ansehen.If you have not been able to pair a Mac, try manually adding a Mac or take a look at the troubleshooting guide.

Manuelles Hinzufügen eines MacsManually add a Mac

Wenn ein bestimmter Mac nicht im Dialogfeld Mit Mac koppeln aufgeführt wird, können Sie diesen manuell hinzufügen:If you do not see a particular Mac listed in the Pair to Mac dialog, add it manually:

  1. Ermitteln Sie die IP-Adresse Ihres Macs.Locate your Mac’s IP address.

    • Öffnen Sie Systemeinstellungen > Freigaben > Entfernte Anmeldung auf Ihrem Mac:Open System Preferences > Sharing > Remote Login on your Mac:

      Die IP-Adresse des Mac-Computers in „Systemeinstellungen > Freigaben“The Mac's IP address in System Preferences > Sharing

    • Alternativ können Sie auch die Befehlszeile verwenden.Alternatively, use the command line. Führen Sie im Terminal den folgenden Befehl aus:In Terminal, issue this command:

      $ ipconfig getifaddr en0
      196.168.1.8
      

      Abhängig von Ihrer Netzwerkkonfiguration müssen Sie möglicherweise nicht en0, sondern einen anderen Schnittstellennamen verwenden.Depending on your network configuration, you may need to use an interface name other than en0. Beispiele sind en1 und en2.For example: en1, en2, etc.

  2. Klicken Sie in Visual Studio 2019 im Dialogfeld Mit Mac koppeln auf Mac hinzufügen... :In Visual Studio 2019's Pair to Mac dialog, select Add Mac...:

    Schaltfläche „Mac hinzufügen...“ im Dialogfeld „Mit Mac koppeln“The Add Mac button in the Pair to Mac dialog

  3. Geben Sie die IP-Adresse des Macs ein, und klicken Sie anschließend auf Hinzufügen:Enter the Mac's IP address and click Add:

    Die IP-Adresse des Mac eingebenEntering the Mac's IP address

  4. Geben Sie Ihren Benutzernamen und Ihr Kennwort für den Mac ein:Enter your username and password for the Mac:

    Benutzernamen und Kennwort eingebenEnter a username and password

    Tipp

    Verwenden Sie bei der Anmeldung Ihren Systembenutzernamen anstelle des vollständigen Namens.When logging in, use your system username rather than full name.

  5. Klicken Sie auf Anmelden, um Visual Studio 2019 über SSH mit dem Mac zu verbinden und den Mac der Liste der bekannten Computer hinzuzufügen.Click Login to connect Visual Studio 2019 to the Mac over SSH and add it to the list of known machines.

Automatische Bereitstellung eines MacsAutomatic Mac provisioning

Ab Version 15.6 von Visual Studio 2019 wird durch das Feature „Mit Mac koppeln“ automatisch eine Software für ein Mac bereitgestellt, die zum Erstellen von Xamarin.iOS-Anwendungen erforderlich ist: Diese umfasst Mono, Xamarin.iOS (das Softwareframework, nicht die IDE Visual Studio für Mac) und verschiedene Tools im Zusammenhang mit Xcode (nicht jedoch Xcode selbst).Starting with Visual Studio 2019 version 15.6, Pair to Mac automatically provisions a Mac with software necessary for building Xamarin.iOS applications: Mono, Xamarin.iOS (the software framework, not the Visual Studio for Mac IDE), and various Xcode-related tools (but not Xcode itself).

Wichtig

  • Xcode kann nicht durch das Feature „Mit Mac koppeln“ installiert werden. Sie müssen die IDE daher manuell auf dem Mac-Buildhost installieren.Pair to Mac cannot install Xcode; you must manually install it on the Mac build host. Xcode ist für die Entwicklung mit Xamarin.iOS erforderlich.It is required for Xamarin.iOS development.
  • Für die automatische Bereitstellung eines Macs muss die Remoteanmeldung auf dem Mac aktiviert sein. Außerdem muss ein Windows-Computer über ein Netzwerk auf den Mac zugreifen können.Automatic Mac provisioning requires that remote login is enabled on the Mac, and the Mac must be network-accessible to the Windows machine. Weitere Informationen finden Sie unter Aktivieren der Remoteanmeldung auf dem Mac.See Enabling remote login on the Mac for more details.
  • Für die automatische Mac-Bereitstellung sind 3 GB freier Speicherplatz auf dem Mac erforderlich, um Xamarin.iOS zu installieren.Automatic Mac provisioning requires 3GB of free space on the Mac to install Xamarin.iOS.

Das Feature „Mit Mac koppeln“ installiert die erforderliche Software oder aktualisiert diese, wenn Visual Studio 2019 eine Verbindung mit dem Mac herstellt.Pair to Mac performs necessary software installations/updates when Visual Studio 2019 is connecting to the Mac.

MonoMono

Das Feature „Mit Mac koppeln“ überprüft, ob Mono installiert ist.Pair to Mac will check to make sure that Mono is installed. Wenn dies nicht der Fall ist, lädt das Feature die neueste stabile Version von Mono auf den Mac herunter.If it is not installed, Pair to Mac will download and install the latest stable version of Mono on the Mac.

In mehreren Eingabeaufforderungen wird der Status angezeigt. Dies ist auf den folgenden Screenshots zu sehen (zum Vergrößern klicken):Progress is indicated by various prompts, as shown by the following screenshots (click to zoom):

MonoMono Überprüfung auf vorhandene InstallationInstall Check Ausgeführter DownloadvorgangDownloading InstallationInstalling
Mono-Installation fehltMissing Mono installation Mono herunterladenDownloading Mono Mono installierenInstalling Mono

Xamarin.iOSXamarin.iOS

Das Feature „Mit Mac koppeln“ führt auf dem Mac für Xamarin.iOS ein Upgrade auf die Version durch, die auf dem Windows-Computer installiert ist.Pair to Mac upgrades Xamarin.iOS on the Mac to match the version installed on the Windows machine.

Wichtig

Auf dem Mac findet keine Herabstufung einer Alpha- oder Betaversion von Xamarin.iOS zu einer stabilen Version statt.Pair to Mac will not downgrade Xamarin.iOS on the Mac from alpha/beta to stable. Wenn Sie Visual Studio für Mac installiert haben, müssen Sie Ihren Releasekanal wie folgt konfigurieren:If you have Visual Studio for Mac installed, set your release channel as follows:

  • Wählen Sie bei Verwendung von Visual Studio 2019 den Updatekanal Stabil in Visual Studio für Mac aus.If you use Visual Studio 2019, select the Stable updates channel in Visual Studio for Mac.
  • Wählen Sie bei Verwendung der Vorschauversion von Visual Studio 2019 den Updatekanal Alpha in Visual Studio für Mac aus.If you use Visual Studio 2019 Preview, select the Alpha updates channel in Visual Studio for Mac.

In mehreren Eingabeaufforderungen wird der Status angezeigt. Dies ist auf den folgenden Screenshots zu sehen (zum Vergrößern klicken):Progress is indicated by various prompts, as shown by the following screenshots (click to zoom):

Xamarin.iOSXamarin.iOS Überprüfung auf vorhandene InstallationInstall Check Ausgeführter DownloadvorgangDownloading InstallationInstalling
Xamarin.iOS-Installation fehltMissing Xamarin.iOS installation Xamarin.iOS herunterladenDownloading Xamarin.iOS Xamarin.iOS installierenInstalling Xamarin.iOS

Xcode-Tools und -LizenzXcode tools and license

Das Feature „Mit Mac koppeln“ überprüft auch, ob Xcode installiert wurde und Sie der Lizenz zugestimmt haben.Pair to Mac will also check to determine whether Xcode has been installed and its license accepted. Obwohl das Feature Xcode nicht installiert, werden Sie dazu aufgefordert der Lizenz zuzustimmen. Dies ist auf den folgenden Screenshots zu sehen (zum Vergrößern klicken):While Pair to Mac does not install Xcode, it does prompt for license acceptance, as shown in the following screenshots (click to zoom):

XcodeXcode Überprüfung auf vorhandene InstallationInstall Check Zustimmung zur LizenzLicense Acceptance
Xcode-Installation fehltMissing Xcode installation Xcode-LizenzXcode license

Zusätzlich installiert oder aktualisiert das Feature „Mit Mac koppeln“ verschiedene Pakete, die mit Xcode verteilt werden.Additionally, Pair to Mac will install or update various packages distributed with Xcode. Zum Beispiel:For example:

  • MobileDeviceDevelopment.pkgMobileDeviceDevelopment.pkg
  • XcodeExtensionSupport.pkgXcodeExtensionSupport.pkg
  • MobileDevice.pkgMobileDevice.pkg
  • XcodeSystemResources.pkgXcodeSystemResources.pkg

Die Installation dieser Pakete erfolgt schnell, und es wird keine Eingabeaufforderung angezeigt.The installation of these packages happens quickly and without a prompt.

Hinweis

Diese Tools unterscheiden sich von den Xcode-Befehlszeilentools, die ab macOS 10.9 zusammen mit Xcode installiert werden.These tools are distinct from the Xcode Command Line Tools, which as of macOS 10.9 are installed with Xcode.

Problembehandlung bei der automatischen Bereitstellung eines MacsTroubleshooting automatic Mac provisioning

Wenn bei der automatischen Bereitstellung eines Macs Probleme auftreten, können Sie sich die Protokolle der Visual Studio 2019-IDE ansehen, die unter %LOCALAPPDATA%\Xamarin\Logs\16.0 gespeichert werden.If you encounter any trouble using automatic Mac provisioning, take a look at the Visual Studio 2019 IDE logs, stored in %LOCALAPPDATA%\Xamarin\Logs\16.0. Diese Protokolle enthalten möglicherweise Fehlermeldungen, die Sie zur effizienteren Diagnose des Fehlers oder für Supportanfragen verwenden können.These logs may contain error messages to help you better diagnose the failure or get support.

Erstellen von iOS-Apps über die Windows-BefehlszeileBuild iOS apps from the Windows command-line

Das Feature „Mit Mac koppeln“ unterstützt die Erstellung von Xamarin.iOS-Anwendungen über die Befehlszeile.Pair to Mac supports building Xamarin.iOS applications from the command line. Zum Beispiel:For example:

C:\samples\App1>msbuild App1.sln /p:ServerAddress=10.211.55.2 /p:ServerUser=xamUser /p:Platform=iPhoneSimulator /p:ServerPassword=mypassword

Die im obigen Beispiel an msbuild übergebenen Parameter sind:The parameters passed to msbuild in the above example are:

  • ServerAddress: die IP-Adresse des Mac-Buildhosts.ServerAddress – The IP address of the Mac build host.
  • ServerUser: der Benutzername, der zur Anmeldung bei dem Mac-Buildhost verwendet wird.ServerUser – The username to use when logging in to the Mac build host. Verwenden Sie Ihren Systembenutzernamen anstelle des vollständigen Namens.Use your system username rather than your full name.
  • ServerPassword: das Kennwort, das zur Anmeldung bei dem Mac-Buildhost verwendet wird.ServerPassword – The password to use when logging in to the Mac build host.

Hinweis

Visual Studio 2019 speichert msbuild im folgenden Verzeichnis: C:\Programme (x86)\Microsoft Visual Studio\2019\<Version>\MSBuild\Current\BinVisual Studio 2019 stores msbuild in the following directory: C:\Program Files (x86)\Microsoft Visual Studio\2019\<Version>\MSBuild\Current\Bin

Wenn sich das Feature „Mit Mac koppeln“ zum ersten Mal über Visual Studio 2019 oder über die Befehlszeile bei einem Mac-Buildhost anmeldet, werden SSH-Schlüssel eingerichtet.The first time Pair to Mac logs in to a particular Mac build host from either Visual Studio 2019 or the command-line, it sets up SSH keys. Durch die Verwendung dieser Schlüssel entfällt bei weiteren Anmeldungen die Angabe des Benutzernamens oder des Kennworts.With these keys, future logins will not require a username or password. Neu erstellte Schlüssel werden unter %LOCALAPPDATA%\Xamarin\MonoTouch gespeichert.Newly created keys are stored in %LOCALAPPDATA%\Xamarin\MonoTouch.

Wenn der ServerPassword-Parameter bei einem Buildaufruf über die Befehlszeile nicht angegeben wird, versucht das Feature „Mit Mac koppeln“, sich mithilfe der gespeicherten SSH-Schlüssel bei dem Mac-Buildhost anzumelden.If the ServerPassword parameter is omitted from a command-line build invocation, Pair to Mac attempts to log in to the Mac build host using the saved SSH keys.

ZusammenfassungSummary

In diesem Artikel wurde erläutert, wie mit dem Feature „Mit Mac koppeln“ Visual Studio 2019 mit einem Mac Buildhost verbunden werden kann. Hierdurch können Visual Studio 2019-Entwickler mit Xamarin.iOS native iOS-Anwendungen erstellen.This article described how to use Pair to Mac to connect Visual Studio 2019 to a Mac build host, enabling Visual Studio 2019 developers to build native iOS applications with Xamarin.iOS.

Nächste SchritteNext steps