共用方式為

安裝工具以建置 iOS

  • 發行項

本主題適用於發行前版本軟體 -- Apache Cordova 的 Visual Studio Tools。這些功能描述於預覽中，但有可能變更。您可以從 Microsoft 下載中心下載此 Preview。

若要在 iOS 模擬器或 iOS 裝置上使用 Visual Studio 建置及執行 iOS 應用程式，您必須在符合以下指定之需求的 Mac 電腦上，安裝及設定遠端代理程式 vs-mda-remote。 (目前無法在 Windows 上建置 iOS 應用程式)。您也必須在電腦上的 Visual Studio 中設定遠端代理程式，如本主題所述。

注意事項注意事項

如果您在 Mac 上使用虛擬化技術執行 Windows，則可以在本機建置及執行 iOS。如需詳細資訊，請參閱使用 Parallels 建置適用於 iOS 的 Cordova 應用程式。如需使用雲端裝載 Mac 服務，而非使用 Mac 的相關資訊，請參閱在雲端中建置及模擬 iOS。

安裝遠端代理程式之前，請確定您已安裝 Visual Studio Tools for Apache Cordova。

安裝及設定遠端代理程式以建置及模擬 iOS

您可以設定代理程式，在 iOS 裝置或 iOS 模擬器上處理組建要求及執行應用程式。 若要裝載遠端代理程式，Mac 電腦必須已安裝下列項目：

  • Mac OS X Mavericks

  • Xcode 6

  • Xcode 命令列工具 (從終端機應用程式中，使用 xcode-select --install)

  • Node.js

您也必須擁有下列項目：

  • 透過 Apple 的使用中 iOS 開發人員計劃帳戶

  • 在 Xcode 中設定的 iOS 佈建設定檔 (下載佈建設定檔，並執行已下載的 *.cer 檔案)

    注意事項注意事項

    如需詳細資訊，請參閱 iOS Developer Library 中的@@@維護您的簽署識別和憑證。

  • 在 Xcode 中設定的簽署身分識別 (請依序選擇 [XCode]、[喜好設定])

下載及安裝遠端代理程式

  • 從 Mac 上的 Terminal 應用程式，輸入：

    sudo npm install -g vs-mda-remote --user=$USER

    其中，您在 Mac 上的使用者名稱會取代 $USER。 執行命令時，系統也會提示您輸入密碼。

    建議使用全域安裝 (-g) 參數，但非必要。

    安裝期間將會在您的 Mac 上安裝 vs-mda-remote 並啟動開發人員模式。 Homebrew 及兩個 npm 封裝也會一併安裝。

    警告

    若要安裝 Homebrew，您需要 sudo (系統管理員) 存取權。如果您沒有 sudo 但要安裝 vs-mda-remote，可手動將 Homebrew 安裝到 usr/local 位置，並將它的 bin 資料夾加入路徑中。如需詳細資訊，請參閱 Homebrew 文件。如果您要手動啟用開發人員模式，請在 Terminal 應用程式中輸入下列程式碼：DevToolsSecurity –enable

如果您已將電腦更新為新版 Visual Studio，也必須將遠端代理程式更新為目前版本。

更新遠端代理程式

  • 重複上一節的安裝步驟。

啟動遠端代理程式

  • 從 Mac 上的 Terminal 應用程式，輸入：

    vs-mda-remote

    隨即會以 ~/remote-builds 的預設組建目錄啟動代理程式。 此主題稍後會描述代理程式的其他組態選項。

    第一次啟動代理程式時，會提供您在 Visual Studio 中設定代理程式的必要資訊，包括主機、連接埠和安全 PIN 碼。

    當您第一次啟動遠端代理程式時的輸出

    重要

    此版本已將 vs-mda-remote 設計為可使用 PIN 碼在 Visual Studio 之間安全地傳輸建置裝載。

  • 如果您要使用主機名稱在 Visual Studio 中設定遠端代理程式，請使用主機名稱 ping 到 Mac 以確認可以存取。 如果不行，您可能要改用 IP 位址。

您必須在 Visual Studio 中指定遠端組態，才能使用遠端代理程式。

從 Visual Studio 設定遠端代理程式

  1. 如果 Mac 上的代理程式尚未執行，請啟動遠端代理程式。

  2. 在您的 Mac 上，取得 Mac 主機名稱或 IP 位址。

    您可以使用 ifconfig 命令取得 IP 位址。

  3. 在 Visual Studio 功能表列上，選擇 [工具]、[選項]。

  4. 在 [選項] 對話方塊中，開啟 [Tools for Apache Cordova]，然後選擇 [遠端代理程式組態]。

  5. 將 [啟用遠端 iOS 處理] 設定為 [True]。

  6. 在 [主機]、[連接埠] 和 [安全 PIN 碼] 欄位中，輸入您初次啟動遠端代理程式時當中所指定的值。 主機可能是您的 Mac 名稱或 IP 位址。 預設連接埠是 3000。

    在 Visual Studio 中設定遠端代理程式

    注意事項注意事項

    如果您無法使用主機名稱 ping 到 Mac，就需要使用 IP 位址。

    按一下 [確認] 時，Visual Studio 即會連線至遠端代理程式 (必須執行代理程式才能連線)。

    如果您要停用安全模式並啟用簡單 HTTP 連線，請在 Terminal 應用程式中輸入下列命令：

    vs-mda-remote --secure false

    接著，在 Visual Studio 中設定代理程式時，您可以讓 [安全 PIN 碼] 欄位保留空白。

停止代理程式

  • 從 Mac 上的 Terminal 應用程式，按下 Ctrl+C。

第一次啟動代理程式時，產生的 PIN 碼是有時效性的 (預設為 10 分鐘)。 如果在時效內您還未連線至代理程式，就必須產生新的 PIN 碼。

產生新的安全 PIN 碼

  1. 停止代理程式 (或在 Mac 上開啟第二個 Terminal 應用程式視窗，以在其中輸入命令)。

  2. 從 Mac 上的 Terminal 應用程式，輸入：

    vs-mda-remote generateClientCert

為了安全性目的，使用遠端代理程式配對出的 Visual Studio 伺服器憑證會與 Mac 的 IP 或主機名稱相關。 如果上述值有所變更，您就必須產生新的伺服器憑證，然後重新使用新值來設定 Visual Studio。

產生新的伺服器憑證

  1. 停止代理程式。

  2. 從 Mac 上的 Terminal 應用程式，輸入：

    vs-mda-remote resetServerCert

  3. 當系統提示時，輸入 "Y" 然後按 Enter。

  4. 從 Mac 上的 Terminal 應用程式，輸入：

    vs-mda-remote generateClientCert

  5. 依照上述指示，輸入新的安全 PIN 碼及 IP 或主機資訊。

您可以使用各種命令列選項來設定遠端代理程式。 例如，您可以指定要接聽組建要求的通訊埠，並指定要在檔案系統上維護的最大組建數目。 (預設上限為 10。 代理程式會在關閉時，移除超出上限的組建)。

警告

自 vs-mda-remote 0.2 版起部分選項已有所變更。最重要的變更為 --buildDir 選項已重新命名為 --serverDir。

設定遠端代理程式

  • 若要查看代理程式命令的完整清單，請輸入：

    vs-mda-remote --help

  • 若要停用安全模式並啟用簡單 HTTP 連線，請輸入：

    vs-mda-remote --secure false

    使用此選項在 Visual Studio 中設定代理程式時，您可以讓 PIN 碼欄位保留空白。

  • 若要指定遠端代理程式檔的位置，請輸入：

    vs-mda-remote --serverDir <directory>

    其中，<directory> 是 Mac 將存放記錄檔、組建與伺服器憑證的位置。 例如，這個位置可能是 /Users/使用者名稱/builds。 (組建會依這個位置的組建編號排列)。

  • 若要使用背景處理序將 stdout 和 stderr 擷取至檔案 (server.log)，請輸入：

    vs-mda-remote > server.log 2>&1 &

    server.log 檔可協助對組建問題進行疑難排解。

  • 若要使用組態檔 (而不是命令列參數) 執行代理程式，請輸入：

    vs-mda-remote --config <path-to-config-file>

    組態檔必須採用 JSON 格式。 啟動選項及其值不可以包含破折號。 若要查看範例組態檔，請查看遠端代理程式安裝目錄中的 vs-mda-remote/examples/exampleConfig.json 資料夾。 例如，這個路徑可以是 /usr/local/lib/node_modules/vs-mda-remote/examples/exampleConfig.json。

確認遠端代理程式組態

  • 在遠端代理程式執行的情況下，開啟第二個 [終端機應用程式] 視窗 (請依序選擇 [殼層]、[開新視窗])。

  • 從 Mac 上的第二個 Terminal 應用程式視窗，輸入：

    vs-mda-remote test

    重要

    如果代理程式在第二個視窗中未執行，這個命令會失敗。

    這個命令會啟動測試組建。 來自命令的輸出應該顯示組建編號及組建的其他資訊，例如其流程。

    啟動測試組建之後，請驗證組建。

  • 如果您在非 3000 的通訊埠上啟動伺服器，請改用下列命令來啟動測試組建：

    vs-mda-remote test http://localhost:<portNumber>

  • 若要確認是否已針對裝置組建正確設定您的開發人員簽署識別 (使用 Visual Studio 中的偵錯和發行組態)，請輸入：

    vs-mda-remote test --device

  • 若要確認是否已針對裝置組建正確設定您的發送簽署識別 (使用 Visual Studio 中的發送組態)，請輸入：

    vs-mda-remote test --device --cfg distribution

    如需應用程式佈建和憑證簽署識別的詳細資訊，請參閱封裝由 Visual Studio Tools for Apache Cordova 建置的應用程式。

有時候，您可能要存取產生的 Xcode 專案來進行原生問題的疑難排解。 幸運的是，您可以快速存取用來建置應用程式的專案。

存取產生的 Xcode 專案

  1. 使用 iOS 模擬器或裝置目標來建置應用程式。

  2. 建置完成之後，請前往 [輸出] 視窗並選取 [顯示來自以下位置的輸出: 組建]。

    最後組建輸出的最終項目看起來大致如下：

    1>  ** BUILD SUCCEEDED **
1>  
1>  Command finished with error code 0: /Users/<username>/remote-builds/builds/8382/cordovaApp/platforms/ios/cordova/build --debug

  3. 在 Mac 上，巡覽至組建輸出中指定路徑的 ios 資料夾。 在上述範例中，此為 /Users/<username>/remote-builds/builds/8382/cordovaApp/platforms/ios

    重要

    停止 vs-mda-remote 代理程式之後，若您沒有使用下列命令啟動 vs-mda-remote，系統就會將組建 (包括產生的 xcode 專案) 刪除：--deleteBuildsOnShutdown false。

  4. 按兩下此資料夾中的 .xcodeproj 檔案，即可在 Xcode 中開啟專案。

請參閱

概念

安裝 Visual Studio Tools for Apache Cordova

在 iOS 上執行 Apache Cordova 應用程式