目標：在iOS的App中獲取到當前包所屬的Git信息。
這里我需要當前代碼的提交日期、提交作者、代碼所屬分支、代碼的節點SHA。
思路：配置script，獲取到需要的Git的信息然后存入info.plist中，需要的時候再從info.plist中取出。
Step1
Xcode-Build Phases-New Run Script Phase
為了和項目中的其他腳本區分開，建議改個名字（雙擊Run Script改名字），Run Script改為Git Script。
Step2
給對應的Target下的info.plist文件增加以下屬性，用于保存腳本執行中設置的Git信息。
Step3
復制粘貼如下腳本到Git Script中：
#最后一次提交的SHA
git_sha=$(git rev-parse HEAD)
#當前的分支
git_branch=$(git symbolic-ref --short -q HEAD)
#最后一次提交的作者
git_last_commit_user=$(git log -1 --pretty=format:'%an')
#最后一次提交的時間
git_last_commit_date=$(git log -1 --format='%cd')
#獲取App安裝包下的info.plist文件路徑
info_plist="${BUILT_PRODUCTS_DIR}/${EXECUTABLE_FOLDER_PATH}/Info.plist"
#利用PlistBuddy改變info.plist的值
//usr/libexec/PlistBuddy -c "Set :'GitCommitSHA' '${git_sha}'" "${info_plist}"
/usr/libexec/PlistBuddy -c "Set :'GitCommitBranch' '${git_branch}'" "${info_plist}"
/usr/libexec/PlistBuddy -c "Set :'GitCommitUser' ${git_last_commit_user}" "${info_plist}"
/usr/libexec/PlistBuddy -c "Set :'GitCommitDate' '${git_last_commit_date}'" "${info_plist}"
Step4
獲取Git信息
- (NSDictionary *)p_gitInfoDict {
NSDictionary *infoDict = [[NSBundle mainBundle] infoDictionary];
NSString *gitSHA = [infoDict objectForKey:@"GitCommitSHA"];
NSString *gitBranch = [infoDict objectForKey:@"GitCommitBranch"];
NSString *gitCommitUser = [infoDict objectForKey:@"GitCommitUser"];
NSString *gitCommitDate = [infoDict objectForKey:@"GitCommitDate"];
gitSHA = [@"GitSHA:" stringByAppendingString:(gitSHA == nil ? @"" : gitSHA)];
gitBranch = [@"GitBranch:" stringByAppendingString:(gitBranch == nil ? @"" : gitBranch)];
gitCommitUser = [@"GitCommitUser:" stringByAppendingString:(gitCommitUser == nil ? @"" : gitCommitUser)];
gitCommitDate = [@"GitCommitDate:" stringByAppendingString:(gitCommitDate == nil ? @"" : gitCommitDate)];
NSDictionary *gitDict = @{@"gitSHA" : gitSHA,
@"gitBranch" : gitBranch,
@"gitCommitUser" : gitCommitUser,
@"gitCommitDate" : gitCommitDate};
return gitDict;
}
注意:
1、多環境的項目，在不同Target下的腳本是一樣的,Xcode會根據不同target下對應的info.plist(比如develop環境,對應info_develop.plist)文件在App的安裝包生成的一個名為info.plist的文件，該文件的路徑為
info_plist="${BUILT_PRODUCTS_DIR}/${EXECUTABLE_FOLDER_PATH}/Info.plist"
不需要根據不同target下的info.plist文件的路徑位置或者名稱的進行重寫。
2、使用模擬器運行的話，如果把腳本刪除后，刪除App重新run依然能夠得Git信息，需要將模擬器Reset。打出來的包不會受此影響。
3、直接運行GitHub鏈接的項目是無法獲得Git信息，因為下載的項目沒有git記錄，自己做些改動然后commit到本地再run即可。
包含子工程的項目請繼續往下看：
iOS子工程獲取Git信息
如果項目中包含子工程，要獲取子工程的git信息，思路如下：
通過shell腳本保存git信息，但是把git保存到安裝包同級目錄下的txt文件中，然后在主工程的腳本中讀取該txt文件，再保存到info.plist中。
實際例子如下：
項目結構圖
項目中中包含2個子工程ShareLibrary、ShareLibrary；
5個target，分別對應Info.plist、Info_Develop.plist、Info_Api.plist、Info_Sim.plist、Info_Feature.plist 5個不同的plist文件。
我們的例子只對一個target進行配置，只保存Git的SHA信息。
Step1:
給info.plist添加字段
Step2:
子工程ShareLibrary添加Git Script,如下圖：
子工程ShareLibrary的Git Script：
#最后一次提交的SHA
git_sha=$(git rev-parse HEAD)
git_filePath="${BUILT_PRODUCTS_DIR}/GitShareLibrary.txt"
touch "$git_filePath"
echo "$git_sha" > "$git_filePath"
Step3:
子工程IMLibrary添加Git Script,如下圖：
子工程IMLibrary的Git Script：
#最后一次提交的SHA
git_sha=$(git rev-parse HEAD)
git_filePath="${BUILT_PRODUCTS_DIR}/GitIMLibrary.txt"
touch "$git_filePath"
echo "$git_sha" > "$git_filePath"
Step4:
主工程Git Script如下：
#子工程git信息txt文件路徑
git_filePath_shareLibrary="${BUILT_PRODUCTS_DIR}/GitShareLibrary.txt"
git_filePath_iMLibrary="${BUILT_PRODUCTS_DIR}/GitIMLibrary.txt"
#主工程和子工程的SHA信息
git_sha_uschoolTeacher=$(git rev-parse HEAD)
git_sha_shareLibrary=`cat "$git_filePath_shareLibrary"`
git_sha_imLibrary=`cat "$git_filePath_iMLibrary"`
#把主工程和子工程的SHA拼接起來
git_sha="UschoolTeacher:$git_sha_uschoolTeacher\n \
IMLibrary:$git_sha_imLibrary\n \
ShareLibrary:$git_sha_shareLibrary"
#獲取App安裝包下的info.plist文件路徑
info_plist="${BUILT_PRODUCTS_DIR}/${EXECUTABLE_FOLDER_PATH}/Info.plist"
#利用PlistBuddy改變info.plist的值
/usr/libexec/PlistBuddy -c "Set :'GitCommitSHA' '${git_sha}'" "${info_plist}"
#刪除生成的git信息txt文件
rm "$git_filePath_shareLibrary"
rm "$git_filePath_iMLibrary"
最后獲取信息：
- (NSDictionary *)p_gitInfoDict {
NSDictionary *infoDict = [[NSBundle mainBundle] infoDictionary];
NSString *gitSHA = [infoDict objectForKey:@"GitCommitSHA"];
STDLog(@"gitSHA:%@",gitSHA);
gitSHA = [@"GitSHA:" stringByAppendingString:(gitSHA == nil ? @"" : gitSHA)];
NSDictionary *gitDict = @{@"gitSHA" : gitSHA};
return gitDict;
}
總結：
弄明白編譯過程中的主工程、子工程之間的順序和Xcode環境變量，就可以通過配置腳本在App中獲取到我們要的git信息。
Xcode把兩個子工程編譯完成后打包成.a文件,
本文引用文章和相關知識點鏈接如下:
參考思路
Git提交信息
PlistBuddy簡單使用
Xcode環境變量
