chenpindong/xunitydeploy

Compile Unity to iOS[Android] client

XUnityDeploy是针对Unity自动化编译Android/IOS的脚本。

环境

• Xcode Version > 7.0

• Ruby Version > 2.0

• Unity Version > 5.0, 其中需要配置Android SDK，JDK, NDK等

• Git or Svn

步骤

• 把XUnityDeploy放在Assets的同级目录

• 拷贝plugins/Editor到Assets/Editor

• 配置参数main.info.json, main.projmods.json, export.plist, unity_deploy.plist

• ruby scripts/run_unity.rb -p ios[android]

XUnityDeploy的流程图

1. 由run_unity启动脚本

2. Ruby脚本生成Unity需要的配置unity_deploy

3. XUnityDeploy读取unity_deploy配置，配置Unity项目，最后编译项目

4. UnityDeployPostprocess在编译Unity之后需要配置Xcode项目(IOS)

   • 读取main.build，获取info
   • 获取projmods，配置Xcode项目
   • 获取info, 配置Xcode的Info.plist

5. 对生成包进行重命名，并提交到down serve上

目录结构说明

• builds 最终生成包的目录(apk, xcode project, ipa)

• configs 配置文件目录

  • unity_deploy.json 是Unity在XUnityDeploy中读取的配置，用于配置Unity的项目
  • android.keystore 是Android的签名文件，需要自己替换，并在unity_deploy中配置keystore
  • export.plist 是导出ipa包xcode需要的配置文件。其中method是app-store,enterprise, ad-hoc,development。参考export.plist

• jenkins jenkins目录

• logs 编译日志目录

• scripts 运行脚本命令目录

• tools 工具目录

• unitys 编译脚本目录

• utils 帮助脚本目录

说明

• executeMethod class 'XUnityDeploy' could not be found 需要把plugins/Editor拷贝到Assets/Editor

• 这里关于xcode项目的配置在Unity的XUnityDeploy处理了，也就是配置main.projmods.json中的build_settings。这里还有一种方法在编译Unity之后，通过Xcodeproj配置xcode

• Error Domain=IDEDistributionErrorDomain Code=1 "The operation couldn’t be completed 修改export.plist

• 因为Unity切换平台(ios/android)比较慢，所以这里建议针对ios/android单独checkout一个目录

TODO

• 检查编译环境的脚本

• 自动提交客户端的脚本

• 用Xcodeproj替代Editor/XCodeEditor