自动修改 Unity3d 导出的 Xcode 项目
在 Unity3d 导出 iOS 项目后,常常需要定制一些选项,例如指定额外的 framework,修改 Info.plist 等。
Unity3d 在导出工程的时候提供两个选项:替换整个项目「replace」和追加变动「append」。一旦使用了 replace 选项,之前所有手工设置的变更都会丢失,需要重新设置。
那么有没有一种方法可以在导出项目的时候对 Xcode 项目进行自动化配置呢?
正好 Unity3d 官方提供了一个叫 xcodeapi 的项目,提供了一套简单易用的接口满足一些常见的定制需求。
从 bitbucket 上下载 xcodeapi 的源码,放到 Unity 项目的 Assets 目录下任意位置,例如 /path/to/project/Assets/Editor/xcodeapi
然后创建一个 MonoBehaviour 的子类,并在其中实现带有 [PostProcessBuild]
属性的 public static void OnPostprocessBuild (BuildTarget BuildTarget, string path);
方法:
如果有多个 PostProcessBuild 属性,可以使用 [PostProcessBuildAttribute(1)] 来指明运行的顺序,详情见此文档。
using UnityEngine;
using UnityEditor;
using UnityEditor.Callbacks;
using UnityEditor.iOS.Xcode;
using System.Collections;
using System.IO;
public class XCodeProjectMod : MonoBehaviour {
[PostProcessBuild]
public static void OnPostprocessBuild (BuildTarget BuildTarget, string path) {
if (BuildTarget == BuildTarget.iPhone) {
// 添加额外的 AssetsLibrary.framework
// 用于检测相册权限等功能
string projPath = PBXProject.GetPBXProjectPath (path);
PBXProject proj = new PBXProject ();
proj.ReadFromString (File.ReadAllText (projPath));
string target = proj.TargetGuidByName ("Unity-iPhone");
// add extra framework(s)
proj.AddFrameworkToProject (target, "AssetsLibrary.framework", false);
// set code sign identity & provisioning profile
proj.SetBuildProperty (target, "CODE_SIGN_IDENTITY", "iPhone Distribution: _______________");
proj.SetBuildProperty (target, "PROVISIONING_PROFILE", "********-****-****-****-************");
// rewrite to file
File.WriteAllText (projPath, proj.WriteToString ());
// 由于我的开发机是英文系统,但游戏需要设置为中文;
// 需要在修改 Info.plist 中的 CFBundleDevelopmentRegion 字段为 zh_CN
// Get plist
string plistPath = path + "/Info.plist";
PlistDocument plist = new PlistDocument();
plist.ReadFromString(File.ReadAllText(plistPath));
// Get root
PlistElementDict rootDict = plist.root;
// Change value of CFBundleDevelopmentRegion in Xcode plist
rootDict.SetString("CFBundleDevelopmentRegion", "zh_CN");
PlistElementArray urlTypes = rootDict.CreateArray("CFBundleURLTypes");
// add weixin url scheme
PlistElementDict wxUrl = urlTypes.AddDict();
wxUrl.SetString("CFBundleTypeRole", "Editor");
wxUrl.SetString("CFBundleURLName", "weixin");
PlistElementArray wxUrlScheme = wxUrl.CreateArray("CFBundleURLSchemes");
wxUrlScheme.AddString("____________");
// Write to file
File.WriteAllText(plistPath, plist.WriteToString());
}
}
}
上面的例子展示了添加 Framework 和 修改 Info.plist 的功能,更多的接口可以参考官方的文档,但是里面的说明并不够详细,可能需要慢慢摸索。