cocos2d-js 3.0 ios平台编译打包

新文档在:
https://github.com/faint2death/cocos2d-js/blob/master/build-ipa.md

  1. 环境配置

MacBook Air,操作系统版本是10.9.3,Xcode版本是5.0.2。把cocos2d-js解压到/Users/x/cocos2d/cocos2d-js-v3.0-beta,配置环境变量:

xtekiMacBook-Air:cocos2d-js-v3.0-beta x$ ./setup.py

Setting up cocos2d-x…
->Check environment variable COCOS_CONSOLE_ROOT
->Find environment variable COCOS_CONSOLE_ROOT…
->COCOS_CONSOLE_ROOT is found : /Users/x/cocos2d/cocos2d-js-v3.0-beta/tools/cocos2d-console/bin

->Configuration for Android platform only, you can also skip and manually edit “/Users/x/.bash_profile”

->Check environment variable NDK_ROOT
->Find environment variable NDK_ROOT…
->NDK_ROOT not found

->Please enter the path of NDK_ROOT (or press Enter to skip):
->Check environment variable ANDROID_SDK_ROOT
->Find environment variable ANDROID_SDK_ROOT…
->ANDROID_SDK_ROOT not found

->Please enter the path of ANDROID_SDK_ROOT (or press Enter to skip):
->Check environment variable ANT_ROOT
->Find environment variable ANT_ROOT…
->ANT_ROOT not found

->Find command ant in system…
->Command ant not found

->Please enter the path of ANT_ROOT (or press Enter to skip):

Please execute command: “source /Users/x/.bash_profile” to make added system variables take effect

xtekiMacBook-Air:cocos2d-js-v3.0-beta x$ source /Users/x/.bash_profile

IOS只需安装Xcode,不需要其他其他SDK。

  1. 编译测试

生成一个测试项目:

xtekiMacBook-Air:cocos2d-js-v3.0-beta x$ cocos new MyGame -l js -d /Users/x/project/

编译这个测试项目:

xtekiMacBook-Air:cocos2d-js-v3.0-beta x$ cd /Users/x/project/MyGame
xtekiMacBook-Air:MyGame x$ cocos compile -p ios

编译后,在项目目录的runtime/ios/下生成MyGame.app目录包,然后可以用xcrun打包:

xtekiMacBook-Air:MyGame x$ xcrun -sdk iphoneos PackageApplication /Users/x/project/MyGame/runtime/ios/MyGame.app -o /Users/x/project/MyGame/MyGame.ipa
xtekiMacBook-Air:MyGame x$ ls -l
total 18328
-rw-r–r-- 1 x staff 9370194 6 16 16:42 MyGame.ipa

这个生成的ipa文件是i386指令集,用于模拟器测试调试。

  1. 真机安装包编译

真机安装包需要证书签名,开发阶段一般有两种:开发和发布,本节讨论的是企业内部发布的in-house证书。

首先,在苹果开发者网站https://developer.apple.com/account/ios/identifiers/bundle/bundleList.action配置App ID,这个App ID后面编译的时候要用到。然后到https://developer.apple.com/account/ios/profile/profileList.action?type=production下载刚才设置App ID的Profile,下载到本地后双击。

双击项目目录frameworks/runtime-src/proj.ios_mac/下的xcodeproj文件,在打开的xcode里设置General里的Bundle Identifier,注意和App ID匹配,下面的Team选择企业发布证书。如果是横屏的游戏,那么在下面的Device Orientation勾选"Landscape Left"和“Landscape Right”,如果是竖屏游戏,那么勾选“Portrait”和“Upside Down”。然后在Build Settings的Code Signing Identity选择开发还是发布,最后在下面的Provisioning Profile选择刚才在苹果开发网站下载的Profile。

需要编译arm指令集的ipa包,那么还要修改cocos2d-js-v3.0-beta/tools/cocos2d-console/plugins/project_compile/project_compile.py关于ios编译参数的修改:

def build_ios(self):


command = ’ '.join(
“xcodebuild”,
“-project”,
“”s\"" projectPath,
“-configuration”,
"s" ‘Debug’ if self._mode is ‘debug’ else ‘Release’,
“-target”,
“”s\"" targetName,
“-sdk”,
“iphonesimulator”,
“-arch i386”,
"CONFIGURATION_BUILD_DIR=s" (output_dir)
])

这里把iphonesimulator改成iphoneos,i386改成armv7,然后在项目目录执行cocos compile -p ios,编译到最后的时候,会调用codesign来做一个签名,会弹出一个钥匙串访问的对话框,选总是允许就可以了。

编译好后,还是用xcrun打包成ipa文件:

xtekiMacBook-Air:MyGame x$ xcrun -v -sdk iphoneos PackageApplication /Users/x/project/MyGame/runtime/ios/MyGame.app -o /Users/x/project/MyGame/MyGame.ipa --sign “iPhone Distribution: xxx”

这个ipa文件还需要一个plist文件配合:

<?xml version="1.0" encoding="UTF-8"?> items assets kind software-package url https://xxx.xxxx.com/magic/MyGame.ipa metadata bundle-identifier com.xxxx.xxxx bundle-version alpha kind software title magic

最后,用这样的html,用户就可以点击下载安装:

点击安装(ios)

IOS 7.1以上版本必须要https才可以正常安装。

现在还有个问题,就是在ipad 1(ios 5.1.1)上闪退,暂时没找到原因。

xtekiMacBook-Air:MyGame x$ xcrun -v -sdk iphoneos PackageApplication /Users/x/project/MyGame/runtime/ios/MyGame.app -o /Users/x/project/MyGame/MyGame.ipa --sign “iPhone Distribution: xxx”

你好,请教一下,最后这个xxx对应啥?

我不能直接打开.xcodeproj文件,在xcode直接运行的吗?

不好意思,新手~~

–sign不要也没关系的,Xcode设置好了证书就行。就是证书的名字。rc0版本的project_compile.py增加了xcrun打包ipa安装包。

这个文档我会再更新。

谢谢回答~~~

再请教几个问题:

  1. 我在Xcode里新建一个工程并运行,是可以在真机上跑的(证书已经安装好了)。cocos2d-js的工程为什么不能这样运行和调试呢?我打开工程点了运行之后,显示Build Succeed就没下文了……手机上没反应。
  2. xcrun打包出ipa文件后,怎么放上真机调试呢?(这个问题可能比较小白,不好意思,新手,对于cocos2d-js, JavaScript, Mac, iOS, Xcode我都是第一次接触…………还请多多包涵)。这样调试能打断点吗?
  3. 用cocos run命令可以跑起来,但是是在模拟器中跑的。请问能指定为在真机上跑吗?另外,模拟器能指定3.5或4英寸的吗?

期待回答,非常感谢 ~~~

  1. 我估计你Xcode当前项目设置的不对,在设置模拟器左边,点击一下,找到图标是A的,选中。比如你的项目名是MyGame,这里应该是MyGame iOS,选它,然后再点左边类似播放的按钮,就会自动编译再在模拟器里运行。可以调试底层C++代码。

  2. 如果你的手机越狱了,那么直接用itools等工具安装ipa。没越狱,如果是开发证书,那么需要在苹果开发网站设置手机序列号白名单。如果用企业证书(299刀一年),可以按照我文档里设置安装,适应再大一点范围的测试。js代码的调试一般我用firefox连到手机或模拟器进行调试,可以打断点。(必须以debug模式编译,frameworks/runtime-src/Classes/AppDelegate.cpp启用了debug)

  3. 不知道。

几经折腾后,现在可以在真机上跑了,但还无法打断点调试

我是这样整的:

  1. 用Cocos Code IDE创建工程(效果跟cocos new命令一样)
  2. 在Mac下打开frameworks\runtime-src\proj.ios_mac下的xcode工程,加签名,然后在真机上运行
  3. 关闭Xcode,手动打开刚刚xcode装上app
  4. 在Cocos Code IDE里填手机的IP,点Run可以在手机上跑,但点Debug就连不上了,目前还不知道为啥…………

Cocos Code IDE我还没用过,用firefox调试更多,晚点试试。