PAServer使用指南

一、安裝平台助理

　　　　使用 FireMonkey 的重要優勢之一是能夠從單個代碼庫為 Windows 和 Mac 編寫程序。 在編寫 Mac OS X 應用程序時，您必須在 Windows 操作系統上使用 RAD Studio 並在 Mac 上部署應用程序。 您可以調試在 Mac OS X 上運行的應用程序和 Mac OS X 的數據包。 要在 Mac 上部署和調試，您需要在 Mac 機器上安裝PAServer。 要調試在其他 Windows 32 和 64 位計算機上運行的應用程序（包括在 Arylzone EC2、Microsoft Azure 或其他雲基礎架構上運行的 Windows 實例），您可以使用 Windows 版本的 Phone Assistant。PAServer不僅易於調試。 您可以使用 IDE 和PAServer來部署應用程序和應用程序所需的任何其他文件。 例如，您的應用程序可能需要額外的 DLL、INI 文件、數據文件、位圖、函數等。為了使用IDE開發跨平台應用程序，您需要在目標平台上安裝並運行PAServer。 文件名為“PAServer”，即遠程應用服務器。 如果直接使用默認端口號（64211），則無需更改參數即可使用平台助手。

 

二、在 Windows/Mac OS X 上安裝 PAServer

1. 將 PAServer 安裝文件傳輸到遠程 Windows 計算機並運行它。 Windows PAServer 安裝文件可以在以下路徑中找到。

　　　　　C:\Program Files\Embarcadero\RAD Studio\xx.0(IDE Version)\PAServer\setup_paserver.exe

 

1. 將 PAServer 安裝文件傳輸到 Mac OS X 計算機並運行它。 Mac PAServer 安裝文件可以在以下路徑中找到：

　　　　   C:\Program Files\Embarcadero\RAD Studio\xx.0(IDE Version)\PAServer\setup_paserver.zip

注意: PAServer 因 IDE 版本而異。 如果您安裝了新版本的Delphi，則必須卸載舊版本並重新安裝與IDE新版本匹配的PAServer版本。 比如XE2更新4，手機也需要更新版本。

PAServer 隨新的 IDE 版本更新

1. 如果您使用PAServer開發跨平台應用程序，請更新IDE（例如XE2 更新）。

   4）安裝完成后，需要先卸載PAServer，再重新安裝更新的PAServer。
   卸載PAServer：使用舊版PAServer.exe從Windows卸載手機助手。 在 Mac 上，使用 delete 命令刪除電話助手(Phone Assistant)。 注意：卸載程序位於 PC 和 Mac 上的電話助手(Phone Assistant)安裝目錄中。在目標平台上安裝更新后的手機助手(Phone Assistant)： 在 Windows 中雙擊 PAServer.exe。在 Mac 上，將 PAServer.zip 文件移動到 Mac 並雙擊 PAServer.zip。

2. 在 Mac 上開始使用 PAServer

　　　　PAServer 將要求提供遠程配置文件密碼以在 RAD Studio IDE 中連接到 Mac。 您可以指定遠程密碼或將其留空。 PAServer顯示 “Acquiring permission to support debugging…（正在獲得支持調試的權限......) ”，對話框顯示“請輸入密碼以訪問其他進程的開發者工具。”輸入Mac管理員名稱和密碼，點擊“Take Control (控制)”按鈕

　　　　

 

 

 注意：

• 開發者工具訪問對話框僅在您第一次啟動PAServer時顯示。如果您沒有輸入正確的密碼（或點擊取消按鈕），系統會提示您“下次訪問開發者工具時開始調試”。

• 您可以在會話的剩余時間（但還不能調試）在 Mac 上運行和部署 OS X 應用程序。當嘗試通過調試運行（例如運行或 F9 等）時，會出現開發人員工具訪問對話框。使用 IDE 調試 OS X 應用程序
  為此，您必須登錄才能訪問開發人員工具。

• 要延遲開發者工具訪問步驟，請啟動手機助手(PAServer)並使用-nopermissioncheck命令行選項：（例如./paserver –nopermissioncheck）此選項設置開發者工具訪問密碼，延遲輸入開發人員工具訪問密碼，直到調試應用程序。

PAServer 命令行選項

　　要顯示詳細幫助，請從命令行啟動 PAServer 並使用 -Help 選項：
PAServer版本 1.0.2

版權所有 2009-2011 Embarcadero Technology Co., Ltd.

用法：paserver [<選項>]
<選項> 是

-port=<nnnnn> 指定端口號 Default=64211
-scratchdir=<dir> 指定客戶臨時文件的父目錄。
-libextension=<cmd> 指定動態庫擴展默認= dylib, h
-tarcommand=<cmd> 指定二進制文件的路徑 Default=/usr/bin/tar

-debuglauncher=<app> 指定調試啟動應用程序。
-nopermissioncheck 不要試圖獲得支持調試的權限。
-unrestricted 允許通過將文件放在客戶臨時文件目錄之外來刪除。
-password=<text> 指定遠程配置文件登錄密碼（默認：提示輸入密碼）
-passfile=<file> 指定遠程配置文件登錄密碼（默認：提示輸入密碼）
-config=<file> 指定首選項。
-help 打印幫助屏幕

 

 

 運行 PAServer 時顯示幫助

在目標平台上啟動 PAServer 后，您可以在提示符下輸入命令。
顯示可以對 PAServer 進程做出反應的五個命令：

•  q - 停止服務器
•  c - 打印所有客戶端
•  p - 打印端口號
•  s - 打印暫存目錄
• g - 創建登錄密碼文件。

 

• Scratch 目錄用於PAServer管理臨時文件，包括遠程配置文件和項目文件。
• .passfile 是包含PAServer加密密碼的密碼文件。 任何想要連接的人都可以共享此文件而不會泄露其個人密碼。

PAServer安裝測試

　　要在 Mac 上編寫 FireMonkey 應用程序，請使用 FireMonkey HD 應用程序向導。

從主菜單中，轉到 File > New 並選擇“FireMonkey HD Application – Delphi”或“FireMonkey HD Application – C++Builder”菜單熱項。從已經創建的項目開始，無需重復這些步驟）

在右上角的項目管理器中，右鍵單擊“Target Platforms”節點並選擇“Add platform…”並從設備列表中選擇“OS X”，然后單擊“OK”按鈕。

 

 

 

在項目管理器窗口中，展開“Target Platform”節點，右鍵單擊“OS X”熱項，在彈出的菜單中選擇“Assign Remote Profile…”。 選擇 ”。 要啟動遠程配置文件向導，請單擊“Select Remote
Profile for OSX Platform”中的“Add…”。 單擊“按鈕。 輸入遠程配置文件名稱（“MyMac”），然后單擊“Next”按鈕。

 

 

 

遠程配置文件向導會詢問您 Mac 的主機名（或 IP 地址）。 向導會顯示 PAServer 使用的默認端口號（可以使用 PAServer 中設置的端口號進行更改）， 用於 PAServer
如果已設置密碼，請在對話框中輸入相同的密碼，然后單擊“測試連接（Test Connection）”。 如果彈出“連接成功”對話框，點擊“確定OK”按鈕。 單擊“下一步Next”按鈕。

 

 

 

 

 

 創建遠程配置文件（僅限 C++Builder 項目）的最后一步是在與 C++ 編譯器的鏈接中指定所需的目錄路徑。 如果您使用 Delphi 編寫 FireMonkey 應用程序，請單擊“完成”按鈕完成遠程配置文件。

如果您正在編寫 C++ FireMonkey 應用程序，則需要指定要在 Mac 上運行的頭文件和庫的位置。 向導輸入遠程路徑列表作為標准 Mac 路徑。

 

 

 C++ 開發者注意：如果你使用的是 Xcode 4.3.x 或更高版本，Apple 會在 Xcode app bundle 中打包文件、庫文件和其他文件，所以“/usr/include”和“/usr/lib”沒有找到文件在文件夾中。 為了使 RAD Studio IDE 能夠在此文件中緩存信息，您必須安裝 Xcode 命令行工具。 在 Xcode 中，轉到 Xcode > Preferences 菜單並單擊preferences首選項窗口中的下載圖標。 如果您已經安裝了命令行工具，您將看到以下信息：

 如果未安裝 Xcode 命令行工具(Xcode command line tools)，請單擊“命令行工具(Command Line Tools)”條目右側的“安裝”按鈕。

單擊“添加新路徑項(Add a new path item)”按鈕，為 Mac 添加額外的包含(include)和庫文件的路徑。

 

 

 添加到遠程計算機的其他路徑后，單擊“完成(Finish)”按鈕。 Mac 遠程配置文件已設置

 

 

 選擇遠程 Mac OS X 配置文件，然后單擊“確定(OK)”按鈕

檢查它是否已編譯並在 Mac 上使用空白手機運行應用程序。 單擊運行圖標（工具欄上的綠色播放按鈕）或按 F9。
如果您正在創建 C++ 項目並首次使用 Mac 遠程配置文件，則會出現一個警告窗口，指出無法找到請求的“MyMac”配置文件。 如果要更新配置文件，請單擊“是”按鈕。 如果您在 Delphi 中創建了項目，則不會出現這些警告對話框。

 

 

 項目將編譯，主應用程序窗口將顯示在 Mac 上，標題中帶有“Form1”。

 

 

 

 要退出程序，請單擊關閉按鈕返回到 IDE。 我嘗試編寫第一個 FireMonkey Mac 應用程序！