這篇文章主要為大家介紹了iOS開發(fā)xconfig和script腳本使用詳解，有需要的朋友可以借鑒參考下。

目錄

• 引言

• Xcode編譯

• Xcode target

• Xcode project

• Xcode scheme

• 新建configuration

• Configuration文件的使用

• 利用Configuration設(shè)置不同的項(xiàng)目名

• 設(shè)置Configuration

• 查看是否設(shè)置成功

• 設(shè)置Info.plist

• 測試是否生效

• 利用xconfig文件實(shí)現(xiàn)OC條件編譯

• xconfig文件的設(shè)置

• Swift中條件編譯的實(shí)現(xiàn)

• script的使用

• script的初步認(rèn)識

• script的實(shí)際運(yùn)用

• 總結(jié)

引言

利用Xcode進(jìn)行開發(fā)時需要進(jìn)行很多build setting的設(shè)置以便能讓項(xiàng)目按照設(shè)置的進(jìn)行編譯，同時有時候需要在編譯時利用script腳本進(jìn)行一些設(shè)置，本文主要介紹xconfig文件和script腳本在Xcode開發(fā)中使用。

Xcode編譯

在使用xconfig時有幾個關(guān)于Xcode的概念是需要理解的，這里我進(jìn)行通俗簡單的說明，同時需要知道Xcode在編譯的過程中具體幫我們做了那幾件事情。

Xcode target

在實(shí)際開發(fā)中一個Xcode創(chuàng)建的項(xiàng)目是可以有多個taget的，比如我們創(chuàng)建一個widget時Xcode會自動新建一個target對應(yīng)這個widget，也可以自己新建，同一個項(xiàng)目有多個target可以滿足不同的測試場景，比如在前期開發(fā)階段使用一個target，到UAT階段使用另外一個target。一個target對應(yīng)一個product，也就是編譯后安裝到手機(jī)上的項(xiàng)目，target定義了生成的唯一 product, 它將構(gòu)建該product 所需的文件和處理這些文件所需的指令集整合進(jìn) build system 中，這些指令以 build setting 和 build phases的形式存在，我們用xconfig文件來設(shè)置 build setting，同時將script腳本添加到build phases 中。

新建target

Xcode project

Xcode project 是一個倉庫，該倉庫包含了所有的文件，資源和用于生成一個或者多個software products 的信息，它包含一個或者多個targets，其中的每一個 target指明了如何生成 products。project為其擁有的所有 targets定義了默認(rèn)的build settings，例如project中默認(rèn)包含debug 和release 兩種build settings 當(dāng)然，每一個 target能夠制定其自己的 build settings，且target 的build settings 會重寫project 的 build settings。

Xcode scheme

一個project可以有多個target，但是當(dāng)前的target只能有一個，scheme就是用來確定當(dāng)前的target的，并制定當(dāng)前的target使用哪種configuration。

新建configuration

打開項(xiàng)目編輯欄選擇上面的progect同時選擇info欄，可以看到Xcode默認(rèn)添加了二個Debug和Release的configuration，點(diǎn)擊做下角的+號按鈕選擇復(fù)制Debug或者Release其中一個configuration來新建并命名一個自己想取的名字，我這里命名為Mamba。

Configuration文件的使用

平時手動的在Xcode中進(jìn)行項(xiàng)目的一些build setting設(shè)置還是比較麻煩的，一個是需要在Xcode中進(jìn)行搜索，另外一個是不好管理，例如需要在debug或者release下進(jìn)行不同的設(shè)置的話就比較麻煩。利用Configuration文件來代替手動設(shè)置則更加的方便，直接新建Configuration Setting file類型文件，如下圖所示：

利用Configuration設(shè)置不同的項(xiàng)目名

Configuration文件是可以繼承的，一般先建立一個Common Configuration文件用來作為父類，為此新建一個名為Common的Configuration文件，并加入如下代碼：

APP_NAME = TestDemo

然后分別新建名為debug，Mamba和release的Configuration文件，并加入如下代碼：

• debug

#include "Common.xcconfig"APP_NAME = $(inherited)Debug

• Mamba

#include "Common.xcconfig"APP_NAME = $(inherited)Mamba

• release

```Swift#include "Common.xcconfig"APP_NAME = $(inherited)Release

上面利用#include進(jìn)行導(dǎo)入依賴的Configuration文件，并利用$(inherited)來引用依賴的Configuration文件中的變量。

Configuration文件中的語法一般是SETTING_NAME = VALUE，具體等式二邊設(shè)置的值可見蘋果官網(wǎng).

設(shè)置Configuration

點(diǎn)擊PROJECT導(dǎo)航欄并選擇Info會發(fā)現(xiàn)多了一個上文我們添加的名為Mamba的Configuration。

點(diǎn)擊左邊的小三角箭頭展開每個Configuration后可以設(shè)置項(xiàng)目的project級別的Configuration File和target級別的Configuration File，當(dāng)然也可以默認(rèn)不設(shè)置。分別設(shè)置三個Configuration下的project級別的Configuration File為Base，target級別的Configuration File則為對應(yīng)的Configuration File，如下圖所示：

查看是否設(shè)置成功

點(diǎn)擊TARGETS導(dǎo)航欄，選擇Build Settings并選中All和Levels滑到最下面可看見APP_NAME的值設(shè)置如下：

這里需要解釋一下幾個設(shè)置的級別：

• Resolved： 最后生效的值

• Target： 顯示在Target級別生效的值，Target級別的優(yōu)先級是高于Project的，并且默認(rèn)繼承Project設(shè)置的值。

• Project： 顯示在Project級別生效的值，往常在Xcode的General設(shè)置的值就是這一級別的。

• iOS Default ： 顯示iOS默認(rèn)設(shè)置的值。

加上Configuration File后優(yōu)先級順序從低到高如下：

• Platform defaults

• Project.xcconfig file

• Project file build settings

• Target .xcconfig file

• Target build settings

設(shè)置Info.plist

最后為了通過Configuration File來控制APP運(yùn)行時名字的顯示，需要在Info.plist中鏈接Bundle display name屬性（沒有的話需要新增）到我們上面設(shè)置的user-defined setting（APP_NAME） 上，為此修改Info.plist中Bundle display name的值為 $(APP_NAME)。

測試是否生效

在Scheme頁面分別選擇debug，release和mamba三中不同的Configuration環(huán)境運(yùn)行APP成功的根據(jù)不同的Configtation設(shè)置不同的項(xiàng)目運(yùn)行名字。

利用xconfig文件實(shí)現(xiàn)OC條件編譯

在開發(fā)中經(jīng)常需要進(jìn)行條件編譯，在OC中可以利用pch文件配合宏來實(shí)現(xiàn)，例如如下：

#ifdef DEBUG#define BaseURL @"192.168.1.1:8080/appname/api"#define PublicKEY @"QWE3R23WR09WURI220WR3TTY5ET3CR2X"#else#define BaseURL @"http://api.appname.com"#define PublicKEY @"32GDG4575UB5M97O7M2X32RFH53QWT43"#endif

通過在pch文件中利用條件編譯定義不用的宏來實(shí)現(xiàn)項(xiàng)目的動態(tài)切換配置，上述宏定義一般定義在.pch中，通常.pch文件中定義的宏都比較雜亂，希望能單獨(dú)放在一個獨(dú)立的文件中，可以通過新建一個頭文件env.h, 把上述宏定義放到env.h中，在需要使用的時候?qū)腩^文件即可，把環(huán)境參數(shù)單獨(dú)放在一個獨(dú)立的頭文件中，更加簡潔，職能更加專一，也便于維護(hù)但是這種做法還不是最好的，因?yàn)檫€需要手動導(dǎo)入頭文件，而且生產(chǎn)環(huán)境參數(shù)和開發(fā)環(huán)境參數(shù)是放在同一個文件中而是不是獨(dú)立分開的，要想獨(dú)立分開并且使用時又不用導(dǎo)入頭文件可以通過Xcode中的Configurations Setting Fil(.xcconfig)來解決，這應(yīng)該是最優(yōu)的實(shí)現(xiàn)方式。

xconfig文件的設(shè)置

在上面的Debug.xconfig和Mamba.xconfig文件中分別加入如下代碼：

• Debug.xconfig

WEBSERVICE_URL = @"www.baidu.com"

• Mamba.xconfig

WEBSERVICE_URL = @"www.jd.com"

這樣只是自定義了一個Build Setting變量，不能代碼里像使用宏那樣使用，Xcode是支持利用GCC_PREPROCESSOR_DEFINITIONS在定義宏的，在Common.xconfig文件中加入如下代碼：

GCC_PREPROCESSOR_DEFINITIONS = $(inherited) WEBSERVICE_URL='$(WEBSERVICE_URL)'

在TARGET導(dǎo)航欄中Preprocessor Macros即可看見我們定義的宏。

代碼使用

可以在代碼中直接使用定義的宏，當(dāng)切換Configuration時則會根據(jù).xconfig文件輸入不同的打印。

- (void)viewDidLoad {    [super viewDidLoad];    NSLog(@"-----------%@-------------",WEBSERVICE_URL);}

使用#include語法來包含其他配置文件，如#include "Common.xcconfig", 最好是放在文件的最后面，放在文件的開頭也可以。Common.xconfig中第一個鍵的配置必須有：GCC_PREPROCESSOR_DEFINITIONS = $(inherited)，沒有Xcode會報(bào)錯，暴露自定義鍵時的語法：宏名='$(key)'，在代碼或其他地方使用宏名來引用，'$(key)'：通過key來指定每個模式下的對應(yīng)的自定義鍵的名字，通常將宏的名字和key的名字保持一致， 注意 等號前后一定不能有空，Common.xconfig中第一個key是GCC_PREPROCESSOR_DEFINITIONS = $(inherited) 后面跟自定義的key，注意在第一個key后面跟上自己定義的key的時候一定不要回車換行，敲一個空格，然后在同一行后面追加就行了，換行會編譯錯誤， 不能換行，不能換行，不能換行！

Swift中條件編譯的實(shí)現(xiàn)

在Swift中是不支持通過GCC_PREPROCESSOR_DEFINITIONS來定義宏的，但是可以通過定義Custom Flags進(jìn)行定義，這里介紹另外一種方法，還是通過.xconfig文件進(jìn)行獲取我們需要的宏。前面我們通過info.plist獲取到了.xconfig文件中自定義的變量，再次我們同樣通過info.plist來獲取自定義的變量的值來當(dāng)做宏使用，首先在info.plist中新建一個WEBSERVICE_URL變量，并設(shè)置值為'$(WEBSERVICE_URL)'，由于需要解析info.plist中的變量，再次封裝一個config.swift的類用來解析：

import Foundationenum Config {  static func stringValue(forKey key: String) -> String {    guard let value = Bundle.main.object(forInfoDictionaryKey: key) as? String else {      fatalError("Invalid value or undefined key")    }    return value  }}

代碼使用

import UIKitclass ViewController: UIViewController {    override func viewDidLoad() {        super.viewDidLoad()        print(Config.stringValue(forKey:"WEBSERVICE_URL"))    }}

相比較于OC版本的是不能直接定義宏，需要通過在info.plist定義后并通過方法取出值后才能使用，稍微麻煩了一點(diǎn)。

script的使用

上文我們已經(jīng)知道xconfig文件的使用，其實(shí)在編譯之前不只是變量的自定義或者獲取項(xiàng)目的一些默認(rèn)參數(shù)，還可以在獲取這些參數(shù)的基礎(chǔ)上，將這些參數(shù)作為script腳本的變量來做一些更有意義的事情，Xcode是支持在編譯之前鏈接script腳本的。

script的初步認(rèn)識

腳本一般來說就是可執(zhí)行的二進(jìn)制文件，下面先制作一個簡單的腳本加深認(rèn)知（實(shí)例代碼采用Swift），首先新建一個名為HelloXcode.swift文件，加入如下代碼：

import Foundation@mainenum MyScript {  static func main() {    print("Hello Xcode")  }}

下面我們用終端來編譯上面的HelloXcode.swift文件，cd到文件所在的目錄執(zhí)行以下代碼：

Bash

xcrun --sdk macosx swiftc -parse-as-library HelloXcode.swift -o CompiledScript

利用macOS SDK來編譯HelloXcode.swift并輸出名為CompiledScript的二進(jìn)制腳本文件，此時可以直接在當(dāng)前目錄利用./CompiledScript執(zhí)行該腳本文件，會直接輸出打印HelloXcode。為了在Xcode編譯階段就能運(yùn)行腳本，我們需要將腳本插入到Xcode的Build Phases中，首先我們先新建一個Build Phases如下所示：

Xcode中的Build Phases選項(xiàng)卡是Xcode build項(xiàng)目的中心，Xcode在編譯項(xiàng)目時其實(shí)幫我們做了如下幾件事情：

• 確定項(xiàng)目的一些依賴并編譯

• 編譯項(xiàng)目的代碼

• 鏈接上面編譯的依賴文件

• 復(fù)制資源文件例如圖片等到項(xiàng)目bundle中

這里我們是要在項(xiàng)目編譯開始之前就運(yùn)行腳本，所以需要調(diào)整新增加的Build Phases的順序，直接拖到Denpencies下面，如下圖所示：

點(diǎn)擊剛剛新加的Build Phases可以重命名，展開后加入如下代碼：

下面的Input Files可以理解為腳本的變量，這里將HelloXcode.swift相對工程文件所在的路$SCRIPT_INPUT_FILE_0進(jìn)行引用，$(SRCROOT)代表工程文件所在的目錄，運(yùn)行項(xiàng)目在build log（不是打印臺）會看見如下輸出：

script的實(shí)際運(yùn)用

利用script來實(shí)現(xiàn)每當(dāng)build的時候改變 Info.plist中Bundle version或者Bundle version string (short)的值，新建一個IncBuildNumber.swift 文件，加入如下代碼：

import Foundation@mainenum IncBuildNumber {  static func main() {    guard let infoFile = ProcessInfo.processInfo      .environment["INFOPLIST_FILE"]    else {      return    }    guard let projectDir = ProcessInfo.processInfo.environment["SRCROOT"] else {      return    }    if var dict = NSDictionary(contentsOfFile:      projectDir + "/" + infoFile) as? [String: Any] {      guard         let currentVersionString = dict["CFBundleShortVersionString"]          as? String,        let currentBuildNumberString = dict["CFBundleVersion"] as? String,        let currentBuildNumber = Int(currentBuildNumberString)      else {        return        }      dict["CFBundleVersion"] = "\(currentBuildNumber + 1)"      if ProcessInfo.processInfo.environment["CONFIGURATION"] == "Release" {        var versionComponents = currentVersionString          .components(separatedBy: ".")        let lastComponent = (Int(versionComponents.last ?? "1") ?? 1)        versionComponents[versionComponents.endIndex - 1] =           "\(lastComponent + 1)"        dict["CFBundleShortVersionString"] = versionComponents          .joined(separator: ".")      }      (dict as NSDictionary).write(        toFile: projectDir + "/" + infoFile,         atomically: true)    }  }}

當(dāng)Xcode在執(zhí)行run script phase時會通過環(huán)境變量environment variables來共享build settings，可以將環(huán)境變量在這里理解為全局變量，這里通過環(huán)境變量拿到了info.plist中的CFBundleShortVersionString和CFBundleVersion變量，并根據(jù)CONFIGURATION配置的是Release還是Debug來修改對應(yīng)的BundleVersion，至此每當(dāng)build時都會改變相應(yīng)的BuildVersion值。

總結(jié)

本文主要介紹了利用xconfig文件如何進(jìn)行項(xiàng)目的動態(tài)配置，并進(jìn)行了實(shí)際的演示，同時介紹了script在Xcode中編譯的基本使用，并配合xconfig文件能讓Xcode在編譯前做更多有意義的事情