Visual Studio文档的新家是docs.microsoft.com上的Visual Studio 2017文档 。html
有关Visual Studio 2017的最新文档，请参阅在docs.microsoft.com上使用iOS安装和配置要构建的工具 。 您可使用Visual C ++进行跨平台移动开发来编辑，调试和将iOS代码部署到iOS模拟器或iOS设备，但因为许可限制，代码必须在Mac上远程构建和运行。 要使用Visual Studio构建和运行iOS应用程序，您须要在Mac上设置和配置远程代理程序vcremote 。 远程代理处理来自Visual Studio的构建请求，并在链接到Mac的iOS设备上或Mac上的iOS模拟器上运行应用程序。node
 注意 |
|---|
| 有关使用云托管的Mac服务而不是Mac的信息，请参阅在云中构建和模拟iOS 。 这些说明适用于使用适用于Apache Cordova的Visual Studio工具进行构建。 要使用说明构建使用Visual C ++进行跨平台移动开发，请将vcremote替换为vs-mda-remote。ios |
一旦安装了使用iOS构建的工具，请参阅本主题了解如何在Visual Studio和Mac上快速配置和更新iOS开发的远程代理。git
先决条件github
启动远程代理xcode
生成一个新的安全PIN码服务器
要安装和使用远程代理为iOS开发代码，必须先具有如下先决条件：
-
运行OS X Mavericks或更高版本的Mac电脑
-
Apple的一个活跃的iOS开发人员计划账户
-
Xcode 6能够从App Store下载。
-
Xcode命令行工具
要安装Xcode命令行工具，请在Mac上打开终端应用程序并输入如下命令：
xcode-select --install -
在Xcode中配置的iOS签名身份
有关获取iOS签名标识的详细信息，请参阅iOS开发者库中的维护签名标识和证书 。 要在Xcode中查看或设置您的签名身份，请打开Xcode菜单并选择首选项 。 选择账户并选择您的Apple ID，而后选择查看详细信息按钮。
-
若是您正在使用iOS设备进行开发，则会在Xcode中为您的设备配置供应配置文件
有关建立配置配置文件的详细信息，请参阅在iOS开发人员库中使用成员中心建立配置配置文件 。
-
npm的更新版本
Node.js附带的npm版本可能不足以安装vcremote。 要更新npm，请在Mac上打开终端应用程序并输入如下命令：
sudo npm install -g npm@latest
当您为跨平台移动开发安装Visual C ++时，Visual Studio能够与vcremote通讯，在Mac上运行的远程代理能够传输文件，构建和运行iOS应用程序并发送调试命令。
在安装远程代理以前，请确保您已知足先决条件并安装了用于跨平台移动开发的Visual C ++ 。
下载并安装远程代理
-
从Mac上的终端应用程序中，输入：
sudo npm install -g --unsafe-perm vcremote建议使用全局安装（ -g ）开关，但不是必需的。
在安装过程当中，vcremote已安装，而且在您的Mac上激活了开发人员模式。 Homebrew和两个npm软件包，vcremote-lib和vcremote-utils也被安装。
注意要安装Homebrew，您必须具备sudo（管理员）访问权限。 若是您须要在不使用sudo的状况下安装vcremote，则能够手动将Homebrew安装在usr / local位置，并将其bin文件夹添加到您的路径中。 有关更多信息，请参阅Homebrew文档 。 要手动启用开发人员模式，请在终端应用程序中输入如下命令：
DevToolsSecurity –enable
若是更新到Visual Studio的新版本，则还必须更新到当前版本的远程代理。 要更新远程代理，请重复这些步骤如下载并安装远程代理。
远程代理必须运行Visual Studio才能生成并运行您的iOS代码。 Visual Studio必须先与远程代理配对，而后才能进行通讯。 默认状况下，远程代理以安全链接模式运行，这须要PIN与Visual Studio配对。
启动远程代理
-
从Mac上的终端应用程序中，输入：
vcremote这将启动具备〜/ vcremote默认构建目录的远程代理。 有关其余配置选项，请参阅在Mac上配置远程代理 。
首次启动代理程序时，以及每次建立新客户端证书时，都会向您提供在Visual Studio中配置代理程序所需的信息，包括主机名，端口和PIN。
若是您打算使用主机名在Visual Studio中配置远程代理，请使用主机名从Windows ping Mac，以验证它是否可访问。 不然，您可能须要使用IP地址。
生成的PIN码一次性使用，仅在有限的时间内有效。 若是您在时间到期以前未将Visual Studio与远程代理配对，则须要生成新的PIN。 有关更多信息，请参阅生成新的安全PIN 。
您能够在不安全模式下使用远程代理。 在不安全模式下，远程代理能够与无需PIN的Visual Studio配对。
禁用安全链接模式
-
要在vcremote中禁用安全链接模式，请在Mac上的终端应用程序中输入如下命令：
vcremote --secure false
启用安全链接模式
-
要启用安全链接模式，请输入如下命令：
vcremote --secure true
一旦你启动了远程代理，你能够在Visual Studio中使用它，直到你中止它为止。
中止远程代理
- 在运行终端窗口vcremote中，输入
Control+C
要从Visual Studio链接到远程代理，必须在Visual Studio选项中指定远程配置。
从Visual Studio配置远程代理
-
若是代理程序还没有在Mac上运行，请按照启动远程代理程序中的步骤进行操做。 您的Mac必须运行Visual Studio的vcremote才能成功配对，链接并构建您的项目。
-
在您的Mac上，获取Mac的主机名或IP地址。
您能够经过在终端窗口中使用ifconfig命令来获取IP地址。 使用活动网络接口下列出的inet地址。
-
在Visual Studio菜单栏上，选择“ 工具” ，“ 选项” 。
-
在“ 选项”对话框中，展开“ 跨平台” ， C ++ ， iOS 。
-
在“ 主机名”和“ 端口”字段中，输入启动时由远程代理指定的值。 主机名称能够是Mac的DNS名称或IP地址。 默认端口是3030。
注意若是您没法使用主机名称ping Mac，则可能须要使用IP地址。
-
若是您在默认安全链接模式下使用远程代理，请选中安全复选框，而后在Pin字段中输入由远程代理指定的PIN值。 若是您在不安全的链接模式下使用远程代理，请清除安全复选框并将引脚字段留空。
-
选择配对以启用配对。
配对一直存在，直到您更改主机名或端口。 若是在“ 选项”对话框中更改主机名或端口，要撤消更改，请选择“ 恢复”按钮以恢复到先前的配对。
若是配对不成功，请按照启动远程代理中的步骤验证远程代理是否正在运行。 若是自生成远程代理程序PIN码以来已过去太多时间，请按照Mac上生成新安全PIN码中的步骤操做，而后重试。 若是您使用的是Mac的主机名，请尝试在主机名字段中使用IP地址。
-
更新远程根目录字段中的文件夹名称，以指定Mac上的主目录（〜）中的远程代理所使用的文件夹。 默认状况下，远程代理使用/ Users /
username/ vcremote做为远程根目录。 -
选择肯定保存远程配对链接设置。
每次使用时，Visual Studio都使用相同的信息链接到Mac上的远程代理。 除非您在Mac上生成新的安全证书或其主机名或IP地址更改，不然不须要再次将Visual Studio与远程代理配对。
第一次启动远程代理时，生成的PIN在有限的时间内有效 - 默认状况下为10分钟。 若是您在时间到期以前未将Visual Studio与远程代理配对，则须要生成新的PIN。
生成新的PIN码
-
中止代理，或在Mac上打开第二个终端应用程序窗口，而后使用它输入命令。
-
在终端应用程序中输入此命令：
vcremote generateClientCert远程代理生成新的临时PIN。 要使用新的PIN配对Visual Studio，请重复在Visual Studio中配置远程代理中的步骤。
出于安全考虑，将Visual Studio与远程代理配对的服务器证书绑定到Mac的IP地址或主机名。 若是这些值更改，则必须生成新的服务器证书，而后使用新值从新配置Visual Studio。
生成新的服务器证书
-
中止vcremote代理。
-
在终端应用程序中输入此命令：
vcremote resetServerCert -
当提示确认时，输入
Y -
在终端应用程序中输入此命令：
vcremote generateClientCert这会生成一个新的临时PIN码。
-
要使用新的PIN配对Visual Studio，请重复在Visual Studio中配置远程代理中的步骤。
您可使用各类命令行选项配置远程代理。 例如，您能够指定端口来侦听构建请求，并指定要在文件系统上维护的最大构建数量。 默认状况下，限制为10个构建。 远程代理将删除在关闭时超过最大值的构建。
配置远程代理
-
要查看远程代理命令的完整列表，请在终端应用程序中输入：
vcremote --help -
要禁用安全模式并启用简单的基于HTTP的链接，请输入：
vcremote --secure false使用此选项时，请清除安全复选框，并在Visual Studio中配置代理时将引脚字段留空。
-
要为远程代理文件指定位置，请输入：
vcremote --serverDir directory_path其中directory_path是Mac上放置日志文件，构建版本和服务器证书的位置。 默认状况下，此位置是/ Users / username / vcremote。 构建按此位置中的构建编号进行组织。
-
要使用后台进程将
stdout和stderr捕获到名为server.log的文件，请输入：vcremote > server.log 2>&1 &server.log文件能够帮助解决构建问题。
-
要使用配置文件而不是命令行参数运行代理，请输入：
vcremote --config config_file_path其中config_file_path是JSON格式的配置文件的路径。 启动选项及其值不能包含破折号。