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 应用程序！