acmhacker / 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

• ios-deploy

步骤

• 把XUnityDeploy放在Assets的同级目录

• 拷贝plugins/Editor到Assets/Editor

• 配置参数XUnityDeploy_configs下的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上

Rake使用

• rake update 更新项目
• rake compile:ios 编译ios项目
• rake compile:android 编译android项目
• rake install:ios 安装ios包
• rake install:android 安装android包

目录结构说明

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

• ../XUnityDeploy_configs 配置文件目录

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

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>compileBitcode</key>
	<false/>
        <key>method</key>
        <string>development</string>
        <key>teamID</key>
        <string>your team id</string>
        <key>provisioningProfiles</key>
        <dict>
            <key>your bundle id</key>
            <string>your provision name</string>
        </dict>
        <key>signingCertificate</key>
        <string>iPhone Developer</string>
        <key>signingStyle</key>
        <string>manual</string>
</dict>
</plist>

• unity_deploy.json 是Unity在XUnityDeploy中读取的配置，用于配置Unity的项目

{
    "ios" :
    {
        "Version" : "1.0",
        "BundleVersionCode": 1,
        "BundleIdentifier" : "com.501joy.over14",
        "ProductName" : "XUnityDeploy",
        "IsDevelopment" : false,
        "DefineSymbols" : "EXAMPLE",
        "StrippingLevel" : "UseMicroMSCorlib",
        "ScriptCallOptimizationLevel" : "FastButNoExceptions",
        "IOSTargetOSVersion" : "7.0",
        "AotOptions" : "nimt-trampolines=256",
        "ScriptBackent" : "IL2CPP",
        "Channel" : "500026"
    },
    "android" :
    {
        "Version" : "1.0",
        "BundleVersionCode" : 1,
        "BundleIdentifier" : "com.501joy.over14",
        "ProductName" : "XUnityDeploy",
        "IsDevelopment" : false,
        "DefineSymbols" : "EXAMPLE",
        "StrippingLevel" : "UseMicroMSCorlib",
        "OBB" : false,
        "ScriptBackent" : "IL2CPP",
        "KeystoreName" : "android.keystore",
        "KeystorePass" : "example",
        "KeyaliasName" : "example",
        "KeyaliasPass" : "example",        
        "Channel" : "600001"
    }
}

• 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。还碰到过WWDR certificate expired, 需要重新更新一下，参考

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

• Error Domain=IDEDistributionErrorDomain Code=14 "No applicable devices found."。这里需要把Ruby版本设置为system，即使用rvm use system 参考

---

关于对i18n支持

在项目中，需要支持游戏APP应用名称多国化，只需要配置一个i18n.projmods.json即可，在i18n.projmods.json中，指定对于的InfoPlist.strings, 比如

    "files": 
    [
        "i18n/en.lproj/InfoPlist.strings",
        "i18n/zh-Hans.lproj/InfoPlist.strings",
        "i18n/zh-Hant.lproj/InfoPlist.strings"
    ],

需要注意的是，在XCProject.cs中，需要ignore重复存在的情况

TODO

• 检查编译环境的脚本

• 自动提交客户端的脚本

• 用Xcodeproj替代Editor/XCodeEditor