Sencha Touch 2 打包成IOS本地应用

准备工作

软件

• Mac OS X 10.6+
• Xcode (iOS 模拟器所需要的)

Apple iOS provisioning 

• Complete iOS provisioning on the Apple iOS provisioning portal and have the certificates and devices setup through the provisioning portal and Xcode.
• Create an App ID and finish provisioning your application. Please refer to the How-To section in the Apple iOS provisioning portal for help. 

  注意: 在打包iOS应用程序的过程中,需要用到App ID和App name。 

在Mac系统上打包iOS系统应用程序的步骤 

1. 前期准备：进入 Apple iOS provisioning portal完成开发者授权。
2. 安装打包程序部分： Sencha SDK Tools 2.0
3. 创建一个配置文件用于打包IOS应用.
4. 运行 packager 打包工具，创建一个App.

Step 1:在Apple iOS provisioning portal完成iOS程序开发者授权 
请点击开发者授权系统Apple iOS provisioning portal 来获得开发和发布应用程序所需要的certificate和profile。 

Step 2: 安装打包程序  
运行Sencha SDK 安装程序: SenchaSDKTools (SenchaSDKTools-2.0.0-Beta)

包含有打包选项的的sencha command会被安装到指定的目录中(默认: Applications/SenchaSDKTools-2.0.0-Beta/command). 

Step 3: 创建一个配置文件供打包iOS程序时使用.

配置文件具有如下的格式: 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

{

    "applicationName": "<AppName>",

    "applicationId": "<AppID>",

    "outputPath": "<AppPackageOutputPath>",

    "iconName": "<AppIconName>",

    "versionString": "<AppVersion>",

    "webAppPath": "<PathToWebApp>",

    "configuration": "<Release| Debug>",

    "platform": "<iOSSimulator| iOS>",

    "deviceType": "<iPhone| iPad | Universal>",

    "certificateAlias": "<(Optional)CertificateAlias>",

    "orientations": [

        "portrait",

        "landscapeLeft",

        "landscapeRight",

        "portraitUpsideDown"

    ]

}

注意:在Mac系统Terminal上运行如下的命令行可以创建配置文件模板: 

1

sencha package generate <configTemplate.json>

<configTemplate.json> 是配置文件的名字. 注意: <configTemplate.json> 的路径和文件名中不能包含空格。 

下面参数用于IOS打包 
  

1

"applicationName":"<AppName>"

AppName 以及AppID都可以在 iOS provisioning portal 中的App IDs部分中找到 
    
                              AppID  

例如上方所示：

• AppName 为 “Sencha Touch 2 Packaging”
• AppID 为 “com.Sencha.Touch2Packaging”

注意:  App ID 需要与你在 Xcode的Identifier field输入的相同 。 

1

2

3

"applicationId":"<AppID>"

 

"outputPath":"<AppPackageOutputPath>"

你打包出文件的输出位置,<application.app>。 

1

"iconName":"<AppIconName>"

你的应用程序所需要的图标文件。 
注意: Retina图标需要在文件名的末尾用@2x标记。例如icon.png （普通的图标文件），[e-mail] (retina图标文件). 如果带有 @2x.png的retina图标存在,打包程序将包含retina图标. 
注意: 请参考 iOS icon guideline 来进一步了解图标文件类型。 

1

"versionString":"<AppVersion>",

application的版本. 

1

"webAppPath":"<PathToWebApp>"

用来打包的web application路径。 

1

"configuration":"<Release | Debug>"

指定创建出程序的类型: Release or Debug. 

1

"platform":"<Simulator | iOS>"

制定创建出程序的运行方式 iOS 模拟器还是iOS设备. 
注意: the iOS simulator cannot run a signed build. A signed build can only be run on the device. 

1

"deviceType":"<iPhone | iPad | Universal>"

指定设备类型.可选项: - iPhone：用于 iPhone 设备 – iPad：用于iPad 设备 – Universal：可用于iphone和iPad二者。 

1

"certificateAlias":"<(Optional)CertificateAlias>"

这是一个非必选项. 你可以指定一个Certificate Alias来给你的app命名。 
注意: 如果忽略此选项，默认的certificate将会是你在iOS Provisioning Portal中建立的那一个。 

1

2

3

4

5

6

"orientations": [

    "portrait",

    "landscapeLeft",

    "landscapeRight",

    "portraitUpsideDown"

]

这是一个可选的配置项. 你可以给app指定方向. 可选项包括: “portrait”, “landscapeLeft”, “landscapeRight” and “portraitUpsideDown”

注意: 如果忽略此选项，默认将包括四个方向。 

Sample debug configuration file  

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

{

    "applicationName":"Sencha Touch 2 Packaging",

    "applicationId":"com.sencha.touch2packaing",

    "iconName":"icon.png",

    "versionString":"1.0",

    "outputPath":"~/Desktop/STBuild-iOS",

    "webAppPath":"~/Desktop/www/",

    "configuration":"Debug",

    "platform":"iOSSimulator",

    "deviceType":"iPhone",

    "orientations": [

        "portrait",

        "landscapeLeft",

        "landscapeRight",

        "portraitUpsideDown"

    ]

}

Sample release configuration file 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

{

    "applicationName":"Sencha Touch 2 Packaging",

    "applicationId":"com.sencha.touch2packaing",

    "iconName":"icon.png",

    "versionString":"1.0",

    "outputPath":"~/Desktop/STBuild-iOS",

    "webAppPath":"~/Desktop/www/",

    "configuration":"Release",

    "platform":"iOS",

    "deviceType":"iPhone",

    "orientations": [

        "portrait",

        "landscapeLeft",

        "landscapeRight",

        "portraitUpsideDown"

    ]

}

Step 4: 运行packager来打包获得一个程序 

打包出一个在iOS 模拟器运行的app

准备工作: 在配置文件中设定Platform 和Configuration参数

例如: 

1

2

"platform":"iOSSimulator"

"configuration":"Debug"

注意: 如果platform,configuration这两个选项没有提供 iOS将不能正常运行。

在终端运行以下命令，可以打包并在iOS上运行一个debug或unsigned的app。 

1

sencha package run <configFile.json>

顺利执行完此命令之后，iOS模拟器将会运行app

注意: “deviceType” 选项将引导启动合适的模拟器: iPhone  iPad. 
 

打包出一个在 iOS 设备上运行的app

在终端运行以下命令，打包出一个在iOS设备上运行的程序

1

sencha package <configFile.json>

注意:  <AppName.app> 将会输出在指定的位置，这是一个你可以在iOS设备上运行的程序。