iOS 開發筆記 - 使用 XCode Subprojects 與 Git Submodule

雖然 Objective C 的經驗不多，但漸漸地會想把一些共用的程式碼弄成 library 來使用，在加上 git 來管理，這時候就會想到 git submodule 的使用。原先以為把 xcode project 拖拉進來就可以了，後來發現這一切都只是幻想 XD 整體上的概念：編譯時要能找到(header search path)，連結時要能找到(link binary)。原本以為拖拉其他 project 進來就能自動化搞動，最後發現還是要手動設定一些環境，所以就來筆記一下。

例如有 Base.xcodeproj 和 Test.xcodeproj，先把常用的程式碼都寫在 Base.xcodeproj：

建立 Xcode Project：

新增 TARGETS -> Add Target：

 

把想要編成 static library 的程式碼擺進 Compile Sources：

使用 git 管理(假設在 /tmp/base.git)：

$ mkdir /tmp/base.git
$ cd /tmp/base.git
$ git init --bare
$ cd /path/Base
$ ls
Base  Base.xcodeproj  BaseLib
$ git init
Initialized empty Git repository in /path/Base/.git/
$ git remote add origin /tmp/base.git
$ git add .
$ git commit -am 'init'
$ git push origin master

在 Test.xcodeproj 裡使用 Base.xcodeproj：

建立 Test xcodeproj：

使用 git 管理(假設在 /tmp/test.git)：

$ mkdir /tmp/test.git
$ cd /tmp/test.git
$ git init --bare
$ cd /path/Test
$ ls
Test  Test.xcodeproj
$ git init
Initialized empty Git repository in /path/Test/.git/
$ git remote add origin /tmp/test.git
$ git add .
$ git commit -am 'init'
$ git push origin master

使用 git submodule 管理 Base library：

$ cd /path/Test
$ ls
Test  Test.xcodeproj
$ git submodule add /tmp/base.git libbase
Cloning into 'libbase'...
done.
$ ls -a
.   .git               Test  libbase
..  .gitmodules  Test.xcodeproj
$ cat .gitmodules
[submodule "libbase"]
  path = libbase
  url = /tmp/base.git
$ git commit -am 'add libbase'
[master 5f69c71] add libbase
  2 files changed, 4 insertions(+)
  create mode 100644 .gitmodules
  create mode 160000 libbase
$ git push origin master

設定 Text.xcodeproj：

拖拉 Base.xcodeproj 進來(從 /path/Test/libbase)：

設定 Header Search (/path/Test/libbase)：

設定 Other Linker Flags：

-all_load  (如果 library 中有 categories)

設定 Link Binary With Libraries：

更新 git：

$ cd /path/Test
$ git add .
$ git commit -am 'add libbase'
$ git push origin master

如此一來，未來在取 Test 的時候，就可以這樣用：

$ git clone --recursive /tmp/test.git testxcode
Cloning into 'testxcode'...
done.
Submodule 'libbase' (/tmp/base.git) registered for path 'libbase'
Cloning into 'libbase'...
done.
Submodule path 'libbase': checked out '920380a7c727d7fb42e38e89bd2eac7a3d2ef72f'
$ ls -a testxcode
.     .git                Test               libbase
..    .gitmodules   Test.xcodeproj

此外，其他時候可能會需要以下指令：

$ git submodule update --init --recursive