Install and Configure Tools to Build using iOSInstall And Configure Tools to Build using iOS

Visual C++ for Cross-Platform Mobile Development を使用して、iOS コードを編集およびデバッグし、iOS シミュレーターまたは iOS デバイスに配置することができます。ただし、ライセンスの制限により、コードのビルドと実行は、リモートの Mac 上で行わなければなりません。You can use Visual C++ for Cross-Platform Mobile Development to edit, debug and deploy iOS code to the iOS Simulator or to an iOS device, but because of licensing restrictions, the code must be built and run remotely on a Mac. Visual Studio を使用して iOS アプリをビルドおよび実行するには、Mac 上にリモート エージェント vcremoteをセットアップして構成する必要があります。To build and run iOS apps using Visual Studio, you need to set up and configure the remote agent, vcremote, on your Mac. このリモート エージェントが、Visual Studio からのビルド要求を処理し、Mac に接続された iOS デバイスまたは Mac 上の iOS シミュレーターでアプリを実行します。The remote agent handles build requests from Visual Studio and runs the app on an iOS device connected to the Mac, or in the iOS Simulator on the Mac.

注意

Mac ではなくクラウド ホスト型 Mac サービスを使用する場合の詳細については、「 Build and Simulate iOS in the Cloud」を参照してください。For information on using cloud-hosted Mac services instead of a Mac, see Build and Simulate iOS in the Cloud. ここでは、Visual Studio Tools for Apache Cordova を使用してビルドする場合の手順を説明します。The instructions are for building using Visual Studio Tools for Apache Cordova. Visual C++ for Cross-Platform Mobile Development を使用してビルドする場合は、vcremote を vs-mda-remote に置き換えて手順に従ってください。To use the instructions to build using Visual C++ for Cross-Platform Mobile Development, substitute vcremote for vs-mda-remote.

iOS を使用してビルドするためのツールをインストールしたら、このトピックを参照して、Visual Studio と Mac で iOS 開発を行うためにリモート エージェントを素早く構成して更新する方法を確認してください。Once you have installed the tools to build using iOS, refer to this topic for ways to quickly configure and update the remote agent for iOS development in Visual Studio and on your Mac.

前提条件Prerequisites

iOS 用リモート エージェントをインストールするInstall the remote agent for iOS

リモート エージェントを起動するStart the remote agent

Visual Studio でリモート エージェントを構成するConfigure the remote agent in Visual Studio

Generate a new security PINGenerate a new security PIN

新しいサーバー証明書を生成するGenerate a new server certificate

Configure the remote agent on the MacConfigure the remote agent on the Mac

前提条件Prerequisites

iOS のコードを開発するためのリモート エージェントをインストールして使用するには、まず、次の前提条件を満たす必要があります。To install and use the remote agent to develop code for iOS, you must first have these prerequisites:

  • OS X Mavericks 以降を実行する Mac コンピューターA Mac computer running OS X Mavericks or later

  • Apple IDAn Apple ID

  • Apple のアクティブな iOS Developer Program アカウントAn active iOS Developer Program account with Apple

  • Xcode 6Xcode 6

    Xcode 6 は、App Store からダウンロードできます。Xcode 6 can be downloaded from the App Store.

  • Xcode コマンド ライン ツールXcode command line tools

    Xcode コマンド ライン ツールをインストールするには、Mac 上でターミナル アプリを開き、次のコマンドを入力します。To install the Xcode command line tools, open the Terminal app on your Mac and enter the following command:

    xcode-select --install

  • Xcode で構成されている iOS 署名 IDAn iOS signing identity configured in Xcode

    iOS 署名 ID を取得する方法の詳細については、iOS Developer Library の「 Maintaining Your Signing Identities and Certificates (署名 ID と証明書の管理) 」を参照してください。For detailed information on obtaining an iOS Signing Identity, see Maintaining Your Signing Identities and Certificates in the iOS Developer Library. Xcode で署名 ID を表示または設定するには、 [Xcode] メニューを開き、 [環境設定] を選択します。To see or set your signing identity in Xcode, open the Xcode menu and choose Preferences. [アカウント] を選択し、自分の Apple ID を選択してから、 [詳細の表示] ボタンを選択します。Select Accounts and choose your Apple ID, and then choose the View Details button.

  • 開発用の iOS デバイスを使用している場合、デバイスのプロビジョニング プロファイルを Xcode で構成します。If you are using an iOS device for development, a Provisioning Profile configured in Xcode for your device

    プロビジョニング プロファイルを作成する方法の詳細については、iOS Developer Library の「 Creating Provisioning Profiles Using Member Center (メンバー センターを使用したプロビジョニング プロファイルの作成) 」を参照してください。For detailed information on creating provisioning Profiles, see Creating Provisioning Profiles Using Member Center in the iOS Developer Library.

  • Node.jsNode.js

  • npm の更新バージョンAn updated version of npm

    Node.js に付属している npm のバージョンは、vcremote をインストールするには古い可能性があります。The version of npm that comes with Node.js may not be recent enough to install vcremote. npm を更新するには、Mac 上でターミナル アプリを開き、次のコマンドを入力します。To update npm, open the Terminal app on your Mac and enter the following command:

    sudo npm install -g npm@latest

iOS 用リモート エージェントをインストールするInstall the remote agent for iOS

Visual C++ for Cross-Platform Mobile Development をインストールすると、Visual Studio は、Mac 上で実行されているリモート エージェント vcremoteと通信して、ファイルを転送したり、iOS アプリをビルドして実行したり、デバッグ コマンドを送信したりできます。When you install Visual C++ for Cross-Platform Mobile Development, Visual Studio can communicate with vcremote, a remote agent running on your Mac to transfer files, build and run your iOS app, and send debugging commands.

リモート エージェントをインストールする前に、 前提条件 を満たしていること、 Visual C++ for Cross-Platform Mobile Developmentをインストール済みであることを確認してください。Before you install the remote agent, make sure you have satisfied the Prerequisites and installed Visual C++ for Cross-Platform Mobile Development.

リモート エージェントをダウンロードしてインストールするにはTo download and install the remote agent

  • Mac 上のターミナル アプリから、次のように入力します。From the Terminal app on your Mac, enter:

    sudo npm install -g --unsafe-perm vcremote

    グローバル インストール (-g) スイッチが推奨されますが、必須ではありません。The global installation (-g) switch is recommended but not required.

    インストール中、Mac に vcremote がインストールされて、開発者モードがアクティブ化されます。During the installation, vcremote is installed and developer mode is activated on your Mac. Homebrew と 2 つのパッケージ (vcremote-lib および vcremote-utils) もインストールされます。Homebrew and two npm packages, vcremote-lib and vcremote-utils, are also installed.

    注意

    Homebrew をインストールするには、sudo (管理者) のアクセス許可が必要です。To install Homebrew, you must have sudo (administrator) access. sudo 以外で vcremote をインストールする必要がある場合には、Homebrew を手動で usr/local の場所にインストールして、その bin フォルダーをパスに追加します。If you need to install vcremote without sudo, you can install Homebrew manually in a usr/local location and add its bin folder to your path. 詳細については、 Homebrew のドキュメントを参照してください。For more information, see the Homebrew documentation. 開発者モードを手動で有効にするには、ターミナル アプリでコマンド DevToolsSecurity -enableを入力します。To manually enable developer mode, enter this command in the Terminal app: DevToolsSecurity -enable

    Visual Studio を新しいバージョンに更新した場合は、リモート エージェントも現在のバージョンに更新する必要があります。If you update to a new version of Visual Studio, you must update to the current version of the remote agent as well. リモート エージェントを更新するには、リモート エージェントをダウンロードしてインストールする手順を繰り返します。To update the remote agent, repeat the steps to download and install the remote agent.

リモート エージェントを起動するStart the remote agent

Visual Studio で iOS コードをビルドして実行するには、リモート エージェントが実行されている必要があります。The remote agent must be running for Visual Studio to build and run your iOS code. Visual Studio がリモート エージェントとペアリングされていないと、Visual Studio はリモート エージェントと通信できません。Visual Studio must be paired with the remote agent before it can communicate. 既定では、リモート エージェントはセキュリティで保護された接続モードで実行されます。この場合、PIN を使用して Visual Studio とペアリングする必要があります。By default, the remote agent runs in secured connection mode, which requires a PIN to pair with Visual Studio.

リモート エージェントを起動するにはTo start the remote agent

  • Mac 上のターミナル アプリから、次のように入力します。From the Terminal app on your Mac, enter:

    vcremote

    これにより、既定のビルド ディレクトリである ~/vcremote でエージェントが起動します。This starts the remote agent with a default build directory of ~/vcremote. 追加の構成オプションについては、「 Configure the remote agent on the Mac」を参照してください。For additional configuration options, see Configure the remote agent on the Mac.

    エージェントを初めて起動するとき、また、新しいクライアント証明書を作成するときは必ず、そのエージェントを Visual Studio に構成するために必要な情報 (ホスト名、ポート、PIN など) が提供されます。The first time you start the agent, and any time you create a new client certificate, you are provided with the required information to configure the agent in Visual Studio, including the host name, the port, and the PIN.

    vcremote を使用してセキュリティで保護された PIN を生成しますUse vcremote to generate a secure PIN

    ホスト名を使用して Visual Studio にリモート エージェントを構成する場合は、Windows からホスト名を使用して Mac を ping し、到達可能であることを確認してください。If you intend to configure the remote agent in Visual Studio using the host name, ping the Mac from Windows using the host name to verify that it is reachable. そうでない場合は、代わりに IP アドレスを使用する必要があります。Otherwise, you may need to use the IP address instead.

    生成される PIN は 1 回限りの使い捨て PIN であり、有効期間は限られています。The generated PIN is for one time use, and is only valid for a limited time. Visual Studio とリモート エージェントをペアリングする前に期限が切れた場合は、新しい PIN を生成する必要があります。If you do not pair Visual Studio with the remote agent before the time expires, you will need to generate a new PIN. 詳細については、「 Generate a new security PIN」を参照してください。For more information, see Generate a new security PIN.

    リモート エージェントは、セキュリティで保護されていないモードでも使用できます。You can use the remote agent in unsecured mode. セキュリティで保護されていないモードでは、PIN なしでリモート エージェントと Visual Studio をペアリングすることができます。In unsecured mode, the remote agent can be paired to Visual Studio without a PIN.

セキュリティで保護された接続モードを無効にするにはTo disable secured connection mode

  • vcremote のセキュリティで保護された接続モードを無効にするには、Mac 上のターミナル アプリで次のコマンドを入力します。To disable secured connection mode in vcremote, enter this command in the Terminal app on your Mac:

    vcremote --secure false

セキュリティで保護された接続モードを有効にするにはTo enable secured connection mode

  • セキュリティで保護された接続モードを有効にするには、次のコマンドを入力します。To enable secured connection mode, enter this command:

    vcremote --secure true

    リモート エージェントを起動した後は停止するまで、Visual Studio からリモート エージェントを使用できます。Once you have started the remote agent, you can use it from Visual Studio until you stop it.

リモート エージェントを停止するにはTo stop the remote agent

  • vcremote が実行されているターミナル ウィンドウで、 Control+Cを押します。In the Terminal window vcremote is running in, enter Control+C.

Visual Studio でリモート エージェントを構成するConfigure the remote agent in Visual Studio

Visual Studio からリモート エージェントに接続するには、Visual Studio のオプションで、リモート構成を指定する必要があります。To connect to the remote agent from Visual Studio, you must specify the remote configuration in the Visual Studio options.

Visual Studio でリモート エージェントを構成するにはTo configure the remote agent from Visual Studio

  1. エージェントが Mac 上でまだ実行されていない場合は、「 リモート エージェントを起動する」の手順に従います。If the agent is not already running on your Mac, follow the steps in Start the remote agent. Visual Studio をリモート エージェントと正常にペアリングして接続し、プロジェクトをビルドするためには、Mac が vcremote を実行している必要があります。Your Mac must be running vcremote for Visual Studio to successfully pair, connect and build your project.

  2. Mac 上で、Mac のホスト名または IP アドレスを取得します。On your Mac, get the host name or IP address of your Mac.

    IP アドレスを取得するには、ターミナル ウィンドウで ifconfig コマンドを使用します。You can get the IP address by using the ifconfig command in a Terminal window. アクティブなネットワーク インターフェイスの下に表示される inet アドレスを使用します。Use the inet address listed under the active network interface.

  3. Visual Studio のメニュー バーで、 [ツール][オプション] の順に選択します。On the Visual Studio menu bar, choose Tools, Options.

  4. [オプション] ダイアログ ボックスで、 [クロス プラットフォーム][C++][iOS] の順に展開します。In the Options dialog box, expand Cross Platform, C++, iOS.

  5. [ホスト名] フィールドと [ポート] フィールドに、リモート エージェントの起動時に示された値を入力します。In the Host Name and Port fields, enter the values specified by the remote agent when you started it. ホスト名には、Mac の DNS 名または IP アドレスを使用できます。The host name can be the DNS name or IP address of your Mac. 既定のポートは 3030 です。The default port is 3030.

    注意

    ホスト名で Mac を ping できない場合は、IP アドレスを使用する必要があります。If you cannot ping the Mac using the host name, you may need to use the IP address.

  6. 既定のセキュリティで保護された接続モードでリモート エージェントを使用する場合は、 [セキュア] チェック ボックスをオンにしてから、リモート エージェントから示された PIN の値を [PIN] フィールドに入力します。If you use the remote agent in the default secured connection mode, check the Secure checkbox, then enter the PIN value specified by the remote agent in the Pin field. セキュリティで保護されていない接続モードでリモート エージェントを使用する場合は、 [セキュア] チェック ボックスをオフにして、 [PIN] フィールドを空白のままにします。If you use the remote agent in unsecured connection mode, clear the Secure checkbox and leave the Pin field blank.

  7. [ペアリングする] を選択してペアリングを有効にします。Choose Pair to enable the pairing.

    iOS のビルドにおける vcremote 接続を構成しますConfigure vcremote connection for iOS builds

    ペアリングは、ホスト名またはポートを変更するまで維持されます。The pairing persists until you change the host name or port. [オプション] ダイアログ ボックスでホスト名またはポートを変更した場合にその変更を元に戻すには、 [元に戻す] ボタンを選択して前のペアリングに戻します。If you change the host name or port in the Options dialog box, to undo the change, choose the Revert button to revert to the previous pairing.

    ペアリングが成功しなかった場合は、「 Start the remote agent」の手順に従って、リモート エージェントが実行されていることを確認します。If the pairing does not succeed, verify that the remote agent is running by following the steps in Start the remote agent. リモート エージェントの PIN が生成されてから経過した時間が長すぎる場合は、Mac 上で「 Generate a new security PIN 」の手順に従ってからもう一度実行します。If too much time has passed since the remote agent PIN was generated, follow the steps in Generate a new security PIN on the Mac and then try again. Mac のホスト名を使用している場合は、代わりに IP アドレスを [ホスト名] に使用してみてください。If you are using the host name of your Mac, try using the IP address in the Host Name field instead.

  8. [リモート ルート] フィールドのフォルダー名を更新して、Mac のホーム (~) ディレクトリ内の リモート エージェントで使用されるフォルダーを指定します。Update the folder name in the Remote Root field to specify the folder used by the remote agent in your home (~) directory on the Mac. 既定では、リモート エージェントはリモート ルートとして /Users/username/vcremote を使用します。By default, the remote agent uses /Users/username/vcremote as the remote root.

  9. [OK] を選択して、リモート ペアリング接続設定を保存します。Choose OK to save the remote pairing connection settings.

    リモート エージェントを使用するたびに、Visual Studio は、この同じ情報を使用して Mac 上のリモート エージェントに接続します。Visual Studio uses the same information to connect to the remote agent on your Mac each time you use it. Visual Studio を再度リモート エージェントにペアリングさせる必要はありません。それが必要になるのは、Mac 上で新しいセキュリティ証明書を生成した場合、あるいは Mac のホスト名または IP アドレスが変更された場合のみです。You do not need to pair Visual Studio with the remote agent again unless you generate a new security certificate on your Mac, or its hostname or IP address changes.

Generate a new security PINGenerate a new security PIN

初めてリモート エージェントを起動すると、生成された PIN が期間限定で有効になります (既定では 10 分)。When you start the remote agent the first time, the generated PIN is valid for a limited amount of time—by default, 10 minutes. Visual Studio とリモート エージェントをペアリングする前に期限切れになった場合は、新しい PIN を生成する必要があります。If you don't pair Visual Studio to the remote agent before the time expires, you will need to generate a new PIN.

新しい PIN を生成するにはTo generate a new PIN

  1. エージェントを停止するか、Mac 上で 2 つ目のターミナル アプリ ウィンドウを開き、それを使用してコマンドを入力します。Stop the agent, or open a second Terminal app window on your Mac and use that to enter the command.

  2. ターミナル アプリで、次のコマンドを入力します。Enter this command in the Terminal app:

    vcremote generateClientCert

    リモート エージェントが新しい一時 PIN を生成します。The remote agent generates a new temporary PIN. 新しい PIN を使用して Visual Studio をペアリングするには、「 Visual Studio でリモート エージェントを構成する」の手順を繰り返します。To pair Visual Studio by using the new PIN, repeat the steps in Configure the remote agent in Visual Studio.

新しいサーバー証明書を生成するGenerate a new server certificate

セキュリティ上の目的で、Visual Studio とリモート エージェントをペアリングするサーバー証明書は、Mac の IP アドレスまたはホスト名と関連付けられています。For security purposes, the server certificates that pair Visual Studio with the remote agent are tied to the IP address or host name of your Mac. これらの値が変更された場合、新しいサーバー証明書を生成し、新しい値で Visual Studio を再構成する必要があります。If these values change, you must generate a new server certificate, and then reconfigure Visual Studio with the new values.

新しいサーバー証明書を生成するにはTo generate a new server certificate

  1. vcremote エージェントを停止します。Stop the vcremote agent.

  2. ターミナル アプリで、次のコマンドを入力します。Enter this command in the Terminal app:

    vcremote resetServerCert

  3. 確認を求めるプロンプトが表示されたら、「 Y」と入力します。When prompted for confirmation, enter Y.

  4. ターミナル アプリで、次のコマンドを入力します。Enter this command in the Terminal app:

    vcremote generateClientCert

    これにより、新しい一時 PIN が生成されます。This generates a new temporary PIN.

  5. 新しい PIN を使用して Visual Studio をペアリングするには、「 Visual Studio でリモート エージェントを構成する」の手順を繰り返します。To pair Visual Studio by using the new PIN, repeat the steps in Configure the remote agent in Visual Studio.

Configure the remote agent on the MacConfigure the remote agent on the Mac

さまざまなコマンド ライン オプションを使用して、リモート エージェントを構成することができます。You can configure the remote agent using various command line options. たとえば、ビルド要求をリッスンするポートを指定したり、ファイル システムに保持するビルドの最大数を指定したりできます。For example, you can specify the port to listen for build requests and specify the maximum number of builds to maintain on the file system. 既定では、10 個のビルドに制限されます。By default, the limit is 10 builds. 最大数を超えたビルドは、リモート エージェントによってシャットダウン時に削除されます。The remote agent will remove builds that exceed the maximum on shutdown.

リモート エージェントを構成するにはTo configure the remote agent

  • リモート エージェントの完全なコマンド一覧を表示するには、ターミナル アプリで次のように入力します。To see a complete list of remote agent commands, in the Terminal app, enter:

    vcremote --help

  • セキュア モードを無効にして、単純な HTTP ベースの接続を有効にするには、次のように入力します。To disable secure mode and enable simple HTTP based connections, enter:

    vcremote --secure false

    このオプションを使用する場合、Visual Studio でエージェントを構成する際に、[セキュア] チェック ボックスをオフにして、[PIN] フィールドを空白のままにします。When you use this option, clear the Secure checkbox and leave the Pin field blank when configuring the agent in Visual Studio.

  • リモート エージェント ファイルの場所を指定するには、次のように入力します。To specify a location for remote agent files, enter:

    vcremote --serverDir directory_path

    ここで directory_path は、ログ ファイル、ビルド、サーバー証明書を配置する Mac 上の場所です。where directory_path is the location on your Mac to place log files, builds, and server certificates. 既定では、この場所は /Users/username/vcremote です。By default, this location is /Users/username/vcremote. ビルドはこの場所でビルド番号順に編成されます。Builds are organized by build number in this location.

  • バックグラウンド プロセスを使用して、server.log という名前のファイルに stdoutstderr をキャプチャするには、次のように入力します。To use a background process to capture stdout and stderr to a file named server.log, enter:

    vcremote > server.log 2>&1 &

    server.log ファイルは、ビルドの問題のトラブルシューティングに役立ちます。The server.log file can assist in troubleshooting build issues.

  • コマンド ライン パラメーターではなく、構成ファイルを使用してエージェントを実行するには、次のように入力します。To run the agent by using a configuration file instead of command-line parameters, enter:

    vcremote --config config_file_path

    ここで config_file_path は JSON 形式の構成ファイルのパスです。where config_file_path is the path to a configuration file in JSON format. スタートアップ オプションとその値にダッシュを含めることはできません。The startup options and their values must not include dashes.

参照See Also

Install Visual C++ for Cross-Platform Mobile DevelopmentInstall Visual C++ for Cross-Platform Mobile Development