Unity xcode api

I'm trying to figure out how to use this,

https://bitbucket.org/Unity-Technologies/xcodeapi

Has anyone figured out yet?

 

Nice, didn't know that existed.

Looks like they're using it here, for example: https://bitbucket.org/Unity-Technol...ssets/Editor/XcodeProjectUpdater.cs?at=stable

 

Someone wrote an example usage here:

http://cflat-inc.hatenablog.com/entry/2015/01/05/074442

Quoted code:

Code (CSharp):

1. using UnityEngine;
2. using UnityEditor;
3. using UnityEditor.Callbacks;
4. using UnityEditor.iOS.Xcode; // ←さっきいれたXcodeAPI
5. using System.Collections;
6. using System.IO;
7.  
8. public class XcodeProjectMod : MonoBehaviour
9. {
10.  
11.     // ちょっとしたユーティリティ関数（http://goo.gl/fzYig8を参考）
12.     internal static void CopyAndReplaceDirectory(string srcPath, string dstPath)
13.     {
14.         if (Directory.Exists(dstPath))
15.             Directory.Delete(dstPath);
16.         if (File.Exists(dstPath))
17.             File.Delete(dstPath);
18.  
19.         Directory.CreateDirectory(dstPath);
20.  
21.         foreach (var file in Directory.GetFiles(srcPath))
22.             File.Copy(file, Path.Combine(dstPath, Path.GetFileName(file)));
23.  
24.         foreach (var dir in Directory.GetDirectories(srcPath))
25.             CopyAndReplaceDirectory(dir, Path.Combine(dstPath, Path.GetFileName(dir)));
26.     }
27.  
28.     [PostProcessBuild]
29.     public static void OnPostprocessBuild(BuildTarget buildTarget, string path)
30.     {
31.         if (buildTarget == BuildTarget.iPhone)
32.         {
33.             string projPath = PBXProject.GetPBXProjectPath(path);
34.             PBXProject proj = new PBXProject();
35.      
36.             proj.ReadFromString(File.ReadAllText(projPath));
37.             string target = proj.TargetGuidByName("Unity-iPhone");
38.  
39.             // システムのフレームワークを追加
40.             proj.AddFrameworkToProject(target, "AssetsLibrary.framework", false);
41.      
42.             // 自前のフレームワークを追加
43.             CopyAndReplaceDirectory("Assets/Lib/mylib.framework", Path.Combine(path, "Frameworks/mylib.framework"));
44.             proj.AddFileToBuild(target, proj.AddFile("Frameworks/mylib.framework", "Frameworks/mylib.framework", PBXSourceTree.Source));
45.  
46.             // ファイルを追加
47.             var fileName = "my_file.xml";
48.             var filePath = Path.Combine("Assets/Lib", fileName);
49.             File.Copy(filePath, Path.Combine(path, fileName));
50.             proj.AddFileToBuild(target, proj.AddFile(fileName, fileName, PBXSourceTree.Source));
51.  
52.             // Yosemiteでipaが書き出せないエラーに対応するための設定
53.             proj.SetBuildProperty(target, "CODE_SIGN_RESOURCE_RULES_PATH", "$(SDKROOT)/ResourceRules.plist");
54.  
55.             // フレームワークの検索パスを設定・追加
56.             proj.SetBuildProperty(target, "FRAMEWORK_SEARCH_PATHS", "$(inherited)");
57.             proj.AddBuildProperty(target, "FRAMEWORK_SEARCH_PATHS", "$(PROJECT_DIR)/Frameworks");
58.      
59.             // 書き出し
60.             File.WriteAllText(projPath, proj.WriteToString());
61.         }
62.     }
63. }

I'm trying to figure this all out at the moment. I need to add frameworks, edit the pch file, add additional linker flags, some files and directories, add url schemes, and so on... so far I could do some of it with help from above code. I might post more on it later in case I figure it all out...

Some things:

* they got the "projPath" wrong for me, I had to change "Unity-iPhone" into "Unity-iPhone.xcodeproj" in "projPath".

* There is a class for handling plist in there, but I'll just use plistbuddy anyway, as it's part of OS X.

* So far I fail at adding a folder "by reference" recursively... I have a folder which contains several subfolder of which some contains extra .framework:s and other libs and files. Somehow adding a folder always adds it as "real" folder... I need it to be a reference (yellow folder in Xcode, not blue).

* I actually have to add the appcontroller.m (replace actual code inside didFinishLaunching.. and more) file on every build. It's a real pain in the neck and I guess it would be hard to pull that off even with these tools... sigh.

 

Hi @Umai, I am facing the same issues that you reported above. Did you find some answers? My main issues are:

* Adding compiler flags to files like `-fno-objc-arc`;

* Conditional compilation in order to add `iPhoneOS` or `iPhoneSimulator` platforms specific lib versions.

Did some of you guys try to use one of the next alternatives?

• onevcat/XUPorter - https://github.com/onevcat/XUPorter
• dcariola/XCodeEditor-for-Unity - https://github.com/dcariola/XCodeEditor-for-Unity
• kronenthaler/mod-pbxproj - https://github.com/kronenthaler/mod-pbxproj

 

Use mod-pbxproj. It says it supports adding a folder "by reference" recursively. The Unity way is dumping everything into Assets/Plugins/iOS. You'd still have to add your frameworks to the project so they can be linked.

You can call mod-pbxproj using (shorthand, missing exception handling, logging output, etc.):
Process myProcess = new Process();
myProcess.StartInfo.FileName = "python";
myProcess.StartInfo.Arguments = ?; // the path to your python file
myProcess.StartInfo.UseShellExecute = false;
// set anything else
myProcess.Start();
myProcess.WaitForExit();

For compiler flags per file, in your python script you need to make a filelist and can do:
project.apply_mods({'compiler_flags': {'-fno-objc-arc': filelist}})
To make the file list I start with filelist = os.listdir(srcDir) and add/remove. I wrote this for a one-off task so apologies it's not generalized.

For adding code each time, you should patch it in using a postprocess.

Unity includes a different lib based on if you're targeting iPhoneOS or iPhoneSimulator so just read that value and add the correct platform specific libs and defines.

 

mod-pbxproj does handle project files correctly. I'd be happy to re-evaluate if you have an example for which it breaks. But we have over a dozen iOS build jobs using it without any issues.

When people use mod-pbxproj incorrectly, then it can break. But all those fixes are outside of the mod-pbxproj script. I've had to fix the postprocess steps of some plugins and it's usually because they made bad assumptions.

The Xcode API provided by Unity is less clear than mod-pbxproj. Having the documentation would be a big help in re-evaluating if it's a better solution. One thing that sticks out is that you have to specify more things when using it, which makes it more prone to breaking/being used incorrectly than mod-pbxproj.

 

Any updates on this? Any plans on more documentation? I use mod-pbxproj as well but if that has the potential to cause problems then I'd like to switch over to a cleaner method.

I used the example files to add links to frameworks, which works fine, but now I tried copying a plugin (which doesn't copy due to a bug in Unity 5 apparently) and the resulting project can't link to the plugin. It builds when I drag the file in by hand however... any ideas? When copying by hand xcode copies the file and adds it to a group as well as assigns a target, i'm trying to do the same procedure in code but kind of stabbing in the dark...

Code (csharp):

1.  
2. var fileName = "metaiosdk";
3. var filePath = Path.Combine("Assets/Plugins/iOS", fileName);
4. File.Copy(filePath, Path.Combine(path, "Libraries/" +fileName));
5. proj.AddFileToBuild(target, proj.AddFile( "Libraries/" + fileName,  "Libraries/" + fileName, PBXSourceTree.Source));
6.  

 

I also have a question about the XCode API. For my project I have to include several libraries to build in Xcode, also the gpg framework which has a filesize of 116MB. This means that I cannot include that file directly into my github repo, cause it is too big. Is there a solution for handling such a case with Unity Cloud build and the XCode API?

Can I maybe download the framework file on the fly everytime Unity Cloud builds my app?
Download link is:

Play Games C++ SDK Version 1.4.1

 

This looks very useful, thanks!

 

Haha, I love it! That Japanese-commented code example, of which I have no idea what they are trying to do or why, seems to be one of the best Unity code examples I've ever read!

Having my own problems to solve and advert plugin -specific XCode setup requirements to follow, I can just look at how the original programmer has used paths, property names and the methods to create solutions.

Yeah, sorry but the Unity Scripting Reference is once again quite unhelpful. I couldn't have used the XCode API without looking at the abovementioned example code to see what kind of paths were expected, or the above forum comment mentioning the bad return value for PBXProject.GetProjectPath method, or what these property names are and where I can look them up.

I'm overjoyed to have seen this thread and that example!

 

I've just been trying to get to grips with this Unity Xcode API as well, and come up against the exact same issues as above. PBXProject.GetProjectPath does seem to return the wrong value. You have to change "Unity-iPhone" into "Unity-iPhone.xcodeproj" in "projPath" to get it to work.
The Unity Docs could seriously do with some good examples adding. This would be a hugely helpful api if it were easier to understand.
As it is, I've gone back to mod_pbxproj, which works and does the job I need it to.

 

I have started using the Xcode Manipulation API and overall it seems to be good. I do have a question regarding adding in a dynamic library. I am trying to add in "libz.1.2.5.dylib" or maybe just "libz.1.dylib".

If I add them in through Xcode, I do it through the "Link Binary with Libraries" from Build Phases. If I try to add in the "lib.1.2.5.dylib" or "libz.1.dylib"using the PBXProject.addFrameworkToProject(), it adds the file, but it is in red in Xcode which would mean that it is missing.

proj.AddFrameworkToProject(target, "libz.1.dylib", false);

I can copy it our of its location in the iOS SDK and add it to my Unity project, copy it to my BuildProject directory, then add it to the Frameworks, but this seems really ineloquent.

Any advise for the best way to add in the dynamic libraries to Xcode?

Thanks

 

I'm guessing that you need the full path of the lib, have you tried that?

 

Thanks for the advice. The full path doesn't work with the AddFrameworkToProject() method, but it does work if I use the AddFileToBuild with the full path...

string libZPath = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/usr/lib/libz.1.dylib";

proj.AddFileToBuild(target, proj.AddFile(libZPath,"Frameworks/libz.1.dylib",PBXSourceTree.Source));

 

Thanks for the follow-up. That works for me.

 

I had a similar problem using the example files and at least solved it on my end.

The example file has the following two lines to set the Framework Search Path...

Code (CSharp):

1. proj.SetBuildProperty(target, "FRAMEWORK_SEARCH_PATHS", "$(inherited)");
2.             proj.AddBuildProperty(target, "FRAMEWORK_SEARCH_PATHS", "$(PROJECT_DIR)/Frameworks");

The problem with that is that the first line ]proj.SetBuildProperty(target, "FRAMEWORK_SEARCH_PATHS", "$(inherited)"); wipes out any existing framework search paths that may already have been added to the project by another plugin.

So in my case, I had a framework in my Unity Project under "Plugins/iOS/AdColony.framework". If I don't run the Post Processor it appears that Unity will automatically add "Plugins/iOS" to the Framework Search Path in Xcode when the project is built.

If I run the example post processor script above it obliterates the "Plugins/iOS/" from the Frameworks Search Path and I have a link compilation error trying to find the headers and I get this...

Code (CSharp):

1. Lexical or Preprocessor Issue
2. UnityADC.mm:18:9: 'AdColony/AdColony.h' file not found

The solution for me and maybe for you... Just don't use

Code (CSharp):

1. proj.SetBuildProperty(target, "FRAMEWORK_SEARCH_PATHS", "$(inherited)");

It shouldn't be necessary anyway as the default empty Unity Project already sets the Framework Search Paths to "$(inherited)" by default.

Currently it appears just to be a good way to introduce incompatibility between third party plugins and cause developers a lot of extra hours figuring it out. I wish they would revise the sample.

 

Is there a way to add a Run Script build phase through the Xcode API? There is a private m_Section dictionary containing the sections but no public API to access it.

 

I am trying to add a library to the Xcode project (libicucode.tbd), I am using this code (as suggested above):

Code (CSharp):

1. proj.AddFileToBuild(targetGUID, proj.AddFile("usr/lib/libicucore.tbd", "Frameworks/libicucore.tbd", PBXSourceTree.Sdk));
2.         proj.AddFileToBuild(targetGUID, proj.AddFile("usr/lib/libicucore.tbd", "Frameworks/libicucore.tbd", PBXSourceTree.Build));

This file is added under Frameworks, but it is not added as input for the "link binary with libraries". I still have to add it manually. Is there any way to add the library using the Xcode API ?

 

For those using Xcode 7 or higher, some libraries are now available using a .tbd file extension. I don't think that Xcode API supports that out of the box. To that end, i have submitted a pull request (https://bitbucket.org/Unity-Technol...sts/12/add-support-for-the-new-tbd-files-with)

Just in case someone wishes to try that out or have a look and let me know if something is wrong or if it looks OK.

 

Unity dudes, could you please address this simple question ..

@povilas

How to simply "copy one file" (say, an audio file or image) from the Unity folder to the built Xcode folder ..

https://stackoverflow.com/questions...-how-exactly-do-you-simply-copy-over-one-file



result in Xcode ...

Code (CSharp):

1.  
2.         project.AddFileToBuild(g, something something something);

It's totally unclear and undocumented how AddFileToBuild works .. thanks

Again, simply add one file to the target Bundle in Xcode ... (imagine a .txt data file, an audio file or whatever).