将用 Visual Studio Tools for Apache Cordova 生成的应用打包

这篇文章介绍了用于 Apache Cordova 的 Visual Studio 工具,是一个预发布的软件。所述功能呈现在预览版中,并可能会发生更改。你可以从 Microsoft 下载中心下载预览版。

当使用适用于 Apache Cordova 的 Visual Studio Tools 将创建的应用打包时,你会希望配置发布应用所需的设置。 除了常规设置之外,在大多数情况下还需要执行针对平台的步骤。

本文内容:

  • 配置常规应用程序包设置

  • 对 Android 应用进行打包和签名

  • 对 iOS 应用进行打包和签名

  • 对 Windows 8、Windows 8.1 或 Windows Phone 8.1 应用进行打包和签名

  • 对 Windows Phone 8 应用进行打包和签名

配置常规应用程序包设置

你可以使用配置设计器来指定详细信息(例如程序包 ID 和版本号),该设计器是针对 config.xml 文件的 Visual Studio 界面。 在解决方案资源管理器中打开 config.xml 的快捷菜单,然后选择“打开”或“查看设计器”(或双击文件)。

Config Deisgner 中的重要设置

你必须配置以下设置才能将应用打包进行分发。

  • “显示名称”,用于指定出现在应用商店中的应用程序的名称。

    备注

    Windows 应用商店显示名称和程序包 ID 是以另一种方法指定的。请参阅本文后面的对 Windows 8、Windows 8.1 或 Windows Phone 8.1 应用进行打包和签名一节。

  • “程序包 ID”,用于指定一个唯一的字符串,在你将应用发布到应用商店中后,该字符串会在每个平台(不包括 Windows 8)上识别你的应用。

  • “版本”,用于指定应用的版本号。 一些应用商店可能会有独立的版本控制,这是在发布应用时分配的。 但对于 iOS 之类的平台,你应该让版本号与你在 iTunes Connect 中配置的版本保持同步。

  • “域访问”,用于指定一组域,让你的应用可以访问这些域的内容。 我们推荐在开发过程中使用默认值“*”,该值能提供对所有内容的访问权限。 但在发布应用之前,请使用此设置来限制你的应用,让其只指定你的应用需要的域。 (Windows 8 目前没有使用此配置设置。)

若要了解可以在 config.xml 中手动设置的首选项,请参阅 Apache Cordova 文档中的 config.xml 文件

对 Android 应用进行打包和签名

每次为 Android 创建应用时,系统就会生成一个程序包。 需要执行更多步骤才能对你的应用进行签名以进行分发。

若要对 Android 应用进行签名以进行分发

  1. 生成一个 keystore,并提供创建证书(私钥)所需的信息。 有关详细信息,请参阅 Android 文档中的对你的应用程序进行签名

  2. 创建 keystore 后,打开 res\native\android 文件夹。

  3. 打开 ant.properties 文件,然后输入关于 keystore 和别名的信息。

    ant.properties 中的 Key.store 属性必须为证书文件指定一个相对或绝对路径。

  4. 将你创建的 keystore 放入作为 ant.properties 的同一个文件夹中,或者放入其他位置。 (例如,出于安全考虑,你可能不想将 keystore 签入源控件中。)

  5. 创建 Android 应用。

    在你创建应用时,Visual Studio 会使用你提供的证书对程序包进行签名。

    警告

    Visual Studio 不会对证书进行验证,所以请确保提供正确的证书。

如果你不小心删除了 ant.properties 文件,请创建一个新项目,然后将文件从新项目复制到上一个项目中。

对 iOS 应用进行打包和签名

若要生成一个能在 iOS 设备上使用的程序包,你需要使用一个有效的 Apple iOS 开发者帐户和一台带 Xcode 的 Mac 来对程序包进行签名。

若要对 iOS 应用进行签名以进行分发

  1. 通过 Apple 开发人员门户为应用创建设置配置文件。

  2. 将配置文件下载并安装在你用作生成计算机的 Mac 上。

  3. 在 Xcode 中,打开“帐户”首选项窗格,检查是否注册了你的 Apple ID。 如果未列出,请选择“+”按钮进行添加。

  4. 在 Visual Studio 中选择一个“调试”、“发布”或“分发”配置。

    • 在创建“调试”或“发布”配置时,Visual Studio 远程代理会选择安装在你的 Mac 上的第一个有效的 iOS 开发签名标识。

    • 在创建“分发”配置时,Visual Studio 远程代理会选择安装在你的 Mac 上的第一个有效的 iOS 分发签名标识。

    重要

    请确保你的 Mac 具有与所选配置对应的合适设置配置文件。

    备注

    如果配置文件标识符与在 Visual Studio 配置设计器中指定的程序包 ID 相匹配,那么签名标识就是有效的。例如,com.msft.multidevice.* 的配置文件与 com.msft.multidevice.someName 的程序包 ID 相匹配。在许多情况下,你可以使用与所有程序包 ID 都匹配的通配符配置文件,此时就无需考虑有效性的问题了。

  5. 创建你的应用。

提示

有关详细信息,请参阅 iOS 开发者库中的维护你的签名标识和证书

对 Windows 8、Windows 8.1 或 Windows Phone 8.1 应用进行打包和签名

Visual Studio 提供了内置功能,可对 Windows 8、Windows 8.1 和 Windows Phone 8.1 应用进行打包以进行分发。 这些包是 APPX 包。

要对 Windows 8、Windows 8.1 或 Windows Phone 8.1 应用进行签名以进行分发

  1. 在 Visual Studio 中依次选择“项目”、“应用商店”和“将应用与应用商店相关联”。

    将应用程序与 Windows Store 关联

  2. 出现提示后,使用你的 Microsoft 帐户登录,为你的应用选择一个名称,然后选择“保留”。

    警告

    应用名称必须在 Windows 应用商店中是唯一的。

  3. 保留应用后,选择“关联”。

    Visual Studio 会更新应用程序包。 若要查看保留的名称用在了哪里,请打开配置设计器,然后在“打包”选项卡中查看显示名称和程序包 ID。

对 Windows Phone 8 应用进行打包和签名

Windows Phone 8 应用是自动打包的,无需在创建时对其进行签名。 你可以按照 Windows 开发人员中心中的提交你的应用 所述来将生成的 XAP 文件提交到应用商店中。

备注

如果将 Windows Phone 8.1 配置为生成目标,则生成的包是 APPX。有关详细信息,请参阅上一节。

如果需要更改 Windows Phone 8 包中的默认语言,请在 bld/Debug/platforms/wp8 中找到 WMAppManifest.xml 文件,修改 <DefaultLanguage code="en-US" /> 标记,并将文件包含在下列文件夹的 Visual Studio 项目中:/res/native/wp8/Properties。 这样,你就可在生成项目中包含自定义 XML 文件。

请参见

概念

发布用 Visual Studio Tools for Apache Cordova 生成的应用

其他资源

FAQ