關於 Xcode 4 靜態函式庫 Static Library 的製作與使用

使用靜態函式庫 Static Library 這類的方法來撰寫程式除了可以讓程式有能被重複利用的特性之外，也能保護您程式不會被有心人士竄改或濫用，Static Library 可以將所有的實做檔 .m 全部包裝成一個副檔名為 .a 的靜態函式庫，當然這個函式庫是無法以正常的手法進行檢視和編輯，就如同在使用 Framework 時只能從眾多的標頭檔 Headers 中查看方法函式的名稱，卻無法得知具體的實做內容。下列文章會將 Xcode 4 靜態函式庫的分成三大部份，分別是環境設定、製作與使用，首先是設定的部份。

如何在 Xcode 4 中設定靜態函式庫 Static Library

首先在開啟新專案中找到 Cocoa Touch Static Library 來製作靜態函式庫的樣板，這是在 iOS SDK 的部份，如果您想要用 Mac OS X 的 BSD C Library 或是 STL C++ Library 等樣板，也同樣沒問題，關於這兩者間的差異稍後會做說明（ 在 Mac OS X 的樣板中記得將函式庫類型由動態設 Dynamic 定成靜態 Static）。

使用 Cocoa Touch Static Library 開始新的專案

如果你想使用現有的程式來製作靜態函式庫，只需要為專案新增 Target （Add Target）並在 Build Phases 中的 Compile Sources 將要匯入靜態函式庫的實做檔案 .m 做好連結，其餘的步驟則完全相同。

在建立好專案（thelib）之後從 TARGETS 的選項 Build Settings 中可以看到這個靜態函式庫所使用的架構 Architectures 與 Base SDK，這個項目將決定這個靜態函式庫適用於什麼樣的架構，如果先前您所使用的樣板是 Mac OS X，那麼這裡會出現的就會是其他項目，如果這個靜態函式庫是要被應用於 iOS 上，則必須改成類似於下圖的設定值。

設定 Targets 的架構與 SDK 版本

如何在 Xcode 4 中製作靜態函式庫 Static Library

在完成環境設定之後，現在我們有了一個空的靜態函式庫，接下來我們為這個空的靜態函式庫加點功能，替這個專案新增一個 NSObject 的 Subclass，在其中使用類別方法實做一個印出字串的功能，程式瑪如下。

Furnace.h
#import <foundation/foundation.h>

@interface Furnace : NSObject {

}
+ (void)showMessage;
@end
Furnace.m
#import "Furnace.h"

@implementation Furnace
+ (void)showMessage {
    NSLog(@"Furnace iOS 中文學習網站");
}
@end

到目前為止整個專案的檔案配置應該會如下圖所示，在 Products 應該是呈現紅字，因為我們還沒對這專案中的 Target 進行編譯。

尚未進行編譯的靜態函式庫

在進行編譯產生靜態函式庫 libthelib.a 之前，還有一件非常重要的事情要做，就是要將 Build 的設定由 Debug 改成 Release，方法是在 Product 中選擇 Edit Scheme，或是直接在 Xcode 4 介面上點選 Scheme 也可以找到 Edit Scheme 項目，接著如下圖所示，將 Build Configuration 由 Debug 改成 Release，就可以對專案的 Target 進行編譯了。

將 Build Configuration 由 Debug 改成 Release

在編譯時請注意您的對象是實體機器，而不是模擬器，在出現 Build Succeeded 之後，原先的 libthelib.a 紅字也已經消失，代表這個靜態函式庫已經製作完成可以使用了，並能直接拖曳到其他專案內。

編譯完成的靜態函式庫

這裡有一個需要特別注意的地方，在 Xcode 中紅字是代表找不到檔案，而在 Xcode 4 的介面中，這個 libthelib.a 是針對實體機器的 Release 和 Debug 而定，如果您是使用模擬器進行編譯，就算編譯成功，在 Xcode 4 的介面上依然會出現紅字，如果要找到使用模擬器編譯出來的靜態函式庫檔案，可在使用者名稱下的 Library/Developer/Xcode/DerivedData/該專案名稱-亂數/Build/Products 中找到，並選擇 Release-iphonesimulator 資料夾中的靜態函式庫 .a 檔來使用。

如何在 Xcode 4 中使用靜態函式庫 Static Library

在使用靜態函式庫前，首先我們必須具備標頭檔 .h 與 靜態函式庫檔 .a，並將這兩個檔拖曳加入到您現在正在使用的專案的 Supporting Files 內，接下來就如同使用 Framework 一般 #import 標頭檔就可以直接使用，程式瑪如下。

#import "Furnace.h"
[Furnace showMessage];

在使用上如果標頭檔眾多或是不想拖曳標頭檔也可以採用檔案連結的方式，設定的方法是在 Targets 中找到 Header Search Paths，將其位置設定成剛剛靜態函式庫專案的位置即可（不需遞迴-尋找到子資料夾），如下圖。

設定引用靜態函式庫的目標位置

最後一個要注意的地方，也是大家常常會忽略的，就是在使用靜態函式庫時，如果是使用模擬器來執行，則你的靜態函式庫就必須是由模擬器所編譯產生，否則就會出現缺少 i386 架構的相關錯誤，如下圖。

使用錯誤的靜態函式庫執行結果

避免此問題出現的方法，就是使用模擬器編譯所產生的靜態函式庫 .a 檔，由模擬器編譯所產生的靜態函式庫檔位置，可參考本文中第二部份，如何在 Xcode 4 中製作靜態函式庫 Static Library 的最後一段。