Sencha-包装-NativePackaging(原生包装) （官网文档翻译26）

本指南介绍了如何打包煎茶触摸应用程序的本地运行iOS或Android设备上使用的煎茶触摸本机打包程序工具。

本机应用程序包装的一般程序

该应用程序的包装过程是非常相同的，无论你的目标iOS或Android设备。主要的区别是，每个环境需要你去完成不同的先决条件。此外，一些创建配置文件的详细信息，两种环境之间的不同。

下面是应用程序包装的基本步骤为：

1 供应。的iOS，你首先需要完成的iOS 苹果iOS配置门户网站，包括证书和设备，通过提供门户网站和Xcode的配置， Android的配置获得一个合适的Android准备的证书签名应用程序（调试或发布）。

2 安装安装打包程序，煎茶SDK工具2.0

3 创建配置文件创建配置文件来使用本机包装机包装。

创建包。运行Packager来创建一个包装

\ <application\>

iOS或一个

APK

文件的Android

应用程序

文件。

这些步骤中的每一步更详细的说明在本指南中，详细介绍了iOS和Android的包装程序之间的差异给予特殊照顾。

所需的软件

在你开始之前，请确保您的计算机运行的是以下内容：

iOS的包装：MAC OS X 10.6 +或Windows Vista的+和Xcode

Android的包装：Android SDK工具（修订16 +）的Eclipse（可选）。

第1步：供应

调配在两个环境之间有所不同，具体如下：

IOS：请参阅原生的iOS调配指南，使用苹果iOS配置门户，成立了相应的发展和分布的认证和配置文件。创建一个应用程序ID，并完成配置您的应用程序。你需要你的应用程序ID和应用程序名称，完成包装工序。请参阅如何“部分中的苹果iOS配置门户帮助。

Android版 ​​本： Android的keytool将包含在Android SDK工具创建Android应用程序进行签名证书的方式之一。下面是一个例子的的keytool命令生成私钥：

$ keytool - genkey - v - keystore my - release - key . keystore - alias alias_name
- keyalg RSA - keysize 2048 - validity 10000

签署您的应用程序创建证书和签名应用程序的更多信息，Android开发者指南。

第2步：安装打包程序

运行煎茶SDK工具安装：SenchaSDKTools（SenchaSDKTools-2.0.0-β）

包括封装选项的的

煎茶

命令，将被安装到指定的位置安装过程中（默认：Applications/SenchaSDKTools-2.0.0-Beta/command）。

第3步：创建一个包装配置文件

创建一个配置文件模板，在终端运行以下命令：

sencha package generate < configTemplate . json >

<configTemplate.json>

的配置文件的名称。它不能包含任何空格。

配置文件应具有以下格式。指出了独特的iOS或Android的参数。需要注意的是参数不遵循任何特定的顺序在实际的配置文件。

{

"applicationName" : "<AppName>" ,
"applicationId" : "<AppID>" ,
"bundleSeedId" : "<String>" ,
( iOS only ) "versionString" : "<AppVersion>" ,
"versionCode" : " <BuildNumber>" ,
( Android only ) "icon" : "<Object>" ,
"inputPath" : "<AppPackageInputPath>" ,
"outputPath" : "<AppPackageOutputPath>" ,
"rawConfig" : "<Info.plistKeys>" ,
( iOS only ) "configuration" : "<Release | Debug>" ,
"notificationConfiguration" : "<Release | Debug>" ,
( iOS only ; optional ) "platform" : "<iOSSimulator | iOS | Android | AndroidEmulator>" ,
"deviceType" : "<iPhone | iPad | Universal>" ,
( iOS only ) "certificatePath" : "<CertificateLocation>" ,
"certificateAlias" : "<CertificateAlias>" ,
( Optional ) "certificatePassword" : "<Password> " ,
( Optional ) "permissions" : "<ApplicationPermissions>" ,
( Android only ) "sdkPath" : "<SDKLocation>" ,
( Android only ) "androidAPILevel" : "<VersionNumber>" ,
( Android only ) "minOSVersion" : "<VersionNumber>" ,
( iOS only ) "orientations" : "<Direction>"
}

本节的其余部分提供了有关各参数的详细信息，并指出特定环境下的设置。

的applicationName

应用程序的名称，它的设备后显示给用户安装的应用程序。

iOS的应用程序的名称的名称相匹配的iOS置备门户，在App ID部分。下面是一个例子，显示的iOS应用程序ID的名称和ID：


应用程序ID

此示例使用下列内容：

应用程式名称：煎茶触摸包装

APPID：com.Sencha.Touch2Packaging

注：在Xcode你把一个在标识符字段中的App ID是一样。

Android版 ​​本：输出的文件将具有的名称<AppName>。apk文件。

的applicationID

为您的应用程序的ID。建议您使用您的应用程序的命名空间，如

com.sencha.Touch2Package

，在上面的例子所示。适用于iOS，这也可以被发现在配置门户网站。

bundleSeedId

（IOS）

这是10个字符的字符串前面的iOS应用程序ID 的iOS置备门户。在上文

的applicationName

所示的例子中，它是

H8A8ADYR7H

。

versionString

这是您的应用程序的版本号。通常需要一个字符串，如

1.0

。

VERSIONCODE

（机器人）

一个Android应用程序的版本号，也被称为整数版本的代码。

图标

随着您的应用程序的名称，图标显示给用户。

IOS：指定用于您的应用程序的图标文件。视网膜图标应指定

@ 2X

结束时的图标的名称。定期

的icon.png

图标的名称看起来像，，而视网膜图标看起来像

（普通）andicon@2x.png

。

@ 2x.png

视网膜图标的存在，打包程序包括视网膜图标。此外，还应指定目标设备的应用程序，如下所示：

"icon":{"57":"resources/icons/Icon.png","72":"resources/icons/Icon~ipad.png","114":"resources/icons/Icon@2x.png","144":"resources/icons/Icon~ipad@2x.png"}

图标大小的具体信息，请参阅苹果的文档。

的Android版 ​​本：指定要用于您的应用程序的启动图标文件。Android的启动图标指南的更多信息，请参阅。

inputPath

这是煎茶触摸应用程序，相对于配置文件的位置。

outputPath

这是打包的应用程序的输出位置，这是内置的应用程序文件将被保存。

rawConfig

（IOS）

“原始”键，可以包含在

info.plist的

配置与iOS应用程序

的Info.plist

的信息属性列表文件与捆绑的可执行文件的配置信息，结构化文本文件的名称。在iOS开发库的更多信息，请参阅信息属性列表文件。

组态

指明是否建立你的应用程序的Debug或Release配置。

调试

应该使用，除非您提交您的应用程序的在线商店，在这种情况下，应指定

释放

。

notificationConfiguration

（iOS的只有）

可选的使用推送通知的应用程序。

调试

应该使用，除非您提交您的应用程序的在线商店，在这种情况下，应指定

释放

。如果应用程序不使用推送通知，留空或删除参数。

平台

指示的平台上运行应用程序。

iOS的选项是

iOSSimulator

或

IOS

。

Android版 ​​本：，选项是

Android

或

AndroidEmulator的

。

的DeviceType

（IOS）

表示iOS设备类型，您的应用程序将运行在。可用选项有：

iPhone

iPad的

普及

certificatePath

这是您的证书的位置。这是必需的，当你为Android开发或正在开发在Windows。

certificateAlias

​​（可选）

表示您的证书名称。这是OSX上进行开发时，没有指定的包装工具会自动尝试使用的applicationID找到证书。

可能只是一个简单的匹配。例如，如果您的证书名称为“iPhone开发者：罗伯特豆干（ABCDEFGHIJ），”，你就可以进入

iPhone开发

。

时不需要使用

certificatePath

在Windows。

certificatePassword

（可选）

如果密码被指定为发布版本的Andr​​oid（IOS或Windows）或任何iOS在Windows上构建生成证书时，只能使用。表示设置的密码证书。如果没有设置密码，留空或消除参数。

权限

（Android的）

阵列的权限调用一个Android应用程序使用的服务，包括粗的位置，优越的地理位置，信息网络，摄像头，等。Android应用程序服务的权限，请参阅完整的列表。

sdkPath

（机器人）

表示的Andr​​oid SDK的路径。

androidAPILevel

（机器人）

表示，该版本的Android SDK使用Android API的水平。有关详细信息，请参阅什么是空气污染指数空气 ​​污染水平在Android SDK文档。一定要安装对应平台的API在Android SDK管理器（android_sdk /工具/机器人）。

minOSVersion

（IOS）

表示数的应用程序运行所需的最低iOS版本。

方向

表示的设备取向中，应用程序可以运行。选项​​有：

肖像

landscapeLeft

landscapeRight

portraitUpsideDown

注意：如果省略，默认方向设置是所有四个方向。

样品的iOS配置文件

下面是一个例子，iOS的配置文件。

{"applicationName":"SenchaAPI","applicationId":"com.sencha.api","outputPath":"~/stbuild/app/","versionString":"1.2","inputPath":"~/stbuild/webapp","icon":{"57":"resources/icons/Icon.png","72":"resources/icons/Icon~ipad.png","114":"resources/icons/Icon@2x.png","144":"resources/icons/Icon~ipad@2x.png"},"rawConfig":"<key>UIPrerenderedIcon</key><true/>","configuration":"debug","notificationConfiguration":"debug","platform":"iOS","deviceType":"iPhone","certificatePath":"stbuild.keystore","certificateAlias":"iPhone Developer","certificatePassword":"stbuild","minOSVersion":"4.0","bundleSeedId":"KPXFEPZ6EF","orientations":["portrait","landscapeLeft","landscapeRight","portraitUpsideDown"]}

样品Android的配置文件

下面是一个例子Android的配置文件。

{"applicationName":"SenchaAPI","applicationId":"com.sencha.api","outputPath":"~/stbuild/app/","versionString":"1.2","versionCode":"12","inputPath":"~/stbuild/webapp","icon":{"57":"resources/icons/Icon.png","72":"resources/icons/Icon~ipad.png","114":"resources/icons/Icon@2x.png","144":"resources/icons/Icon~ipad@2x.png"},"configuration":"debug","platform":"android","certificatePath":"stbuild.keystore","certificateAlias":"Android Developer","certificatePassword":"stbuild","permissions":["INTERNET","ACCESS_NETWORK_STATE","CAMERA","VIBRATE","ACCESS_FINE_LOCATION","ACCESS_COARSE_LOCATION","CALL_PHONE"],"sdkPath":"/android_sdk-mac_86/","androidAPILevel":"7","orientations":["portrait","landscapeLeft","landscapeRight","portraitUpsideDown"]}

第4步：运行Packager建立打包的应用程序

创建配置文件后，下一个步骤是打包的应用程序。这里有包装iOS和Android的应用程序的调试和发布版本的程序。

IOS：包调试应用程序

适当的

平台

和

配置

需要在配置文件中的设置，例如：

平台：iOSSimulator的
配置：调试

如果没有设置

平台

和

配置

，打包应用程序将无法正常运行。

有了这些的configs设置正确，在终端发出以下命令：

煎茶包运行CONFIGFILE 。JSON >

在这个例子中，它的目标是iPhone模拟器在

平台

配置参数，成功地完成

包

命令启动的iOS模拟器运行的应用程序本身。需要注意的是

DeviceType的

标识符-

iPhone

或

iPad的

-要正确设置触发相应的模拟器。

IOS：包发布的应用程序

打包签名的应用程序在设备上运行，在终端发出以下命令：

煎茶包CONFIGFILE 。JSON >

注意：指定的输出位置中创建一个

<AppName.app>

。这是你可以使用的应用程序部署到iOS设备。

Android版本：调试应用程序包和运行在Android模拟器

适当的

平台

和

配置

需要在配置文件中的设置，例如：

的平台：AndroidEmulator
配置：调试

如果没有设置

平台

和

配置

，打包应用程序将无法正常运行。

有了这些设置正确的configs，启动Android模拟器，并发出以下命令：

煎茶包运行CONFIGFILE 。JSON >

在这个例子中，它的目标是Android模拟器的

平台

配置参数，成功地完成

包

命令启动应用程序，在已经运行的模拟器。如果

包

是成功的

。APK

应用程序中的输出位置，您可以手动在Android仿真器或设备进行测试。

关于Android仿真器的更多信息，可以发现在Android开发者指南：使用Android仿真器。

Android版本：软件包的应用程序分发

打包签名的应用程序在设备上运行，请发出以下命令：

煎茶包CONFIGFILE 。JSON >

创建一个

<AppName.apk>

是在指定的输出位置。这是你可以用它来 ​​释放分配的应用程序。

其他资源

iOS的资源

原生的iOS调配

苹果iOS配置门户网站

的iOS图标准则

Android的资源

您的应用程序签名

为Eclipse安装ADT插件

日食

管理Android模拟器的虚拟设备，虚拟设备“。