2014年7月27日 星期日

GPUImage 滿漢大餐: 下載 GPUImage & 編譯成 Framework 來使用

繼續之前的部份,要使用第三方 Library 的第一個步驟就是先下載它,
那麼就來下載吧。

下載

GPUImage git 頁面的網址是:https://github.com/BradLarson/GPUImage
有幾個下載的方法,這邊我就教其中的兩個。

第一個:直接下載,這是最簡單的方式,只要找到右邊的 Download ZIP,就可以下載它了。

第二個:使用 git clone 來下載它,在 Download ZIP 的上方能找到 HTTPS clone URL,那邊就是下載用的網址,
只要下在終端機中下 "git clone 網址" 這個指令就能了。

下載完成後到你下載的目錄中找到 GPUImage 的目錄,
這時候能看到這些檔案,如下圖

檔案的用途與說明如下:
build.sh這是要編譯成 Framework 的檔案,這等等會教怎麼使用。
examples這是範例的資料夾,這個有興趣的人就自己看吧
framework原始檔案都放在這裡面,不想使用 Framework 的人可以直接使用裡面的檔案
GPUImage.podspec這是 Cocoa Pod 的描述檔,不過這邊不會用到它
License.txt這是放這個第三方 Library 使用哪個 License,在這邊是使用 BSD-style License
README.md這是這個第三方 Library 的基本描述與說明

使用

下載完畢後就是將它放入自己的專案中使用,
在 GPUImage 的目錄中找到 framework 下面的 Source 資料夾,
這個資料夾裡面都是放著 GPUImage 的原始檔案,
所以這個資料夾可以直接放入你自己的專案中使用。

編譯成 Framework

剛剛說到的 build.sh 是編譯成 Framework 來用的,
但是在編譯之前有一件事要做,
build.sh 裡面有一個參數要修改,
所以要先用文字編輯器來打開它,看你們習慣用哪一個打開就用那一個吧,

它個前段內容如下:
#!/bin/bash

set -e

IOSSDK_VER="7.0"

# xcodebuild -showsd

在那裡面能找到 IOSSDK_VER="7.0" 這一行,
這是在描述你的 iOS SDK 的版本,它個預設是使用 7.0,
如果你想要編譯成 6.0 版本的人,可以將它改成 6.0,
修改完之後將它存檔,可以準備進行編譯了。

開始編譯之前,請檢查一下 build.sh 的檔案屬性是否為 "可執行" 的,
檢查的方法是,請開啟你的終端機,切換目錄到 GPUImage 的目錄底下,
輸入 ls -la 的指令,就能看到這個目錄底下所有的檔案屬性。
(我在圖中輸入的 ll 就是 ls -la 的縮寫,這就與本次的主題無關,就不教如何使用了)

這時後檢查一下 build.sh 的檔案屬性有沒有如下的x
-rwxr-xr-x@ 1 darktt staff 1159 Jul 24 20:46 build.sh

如果沒有的話就請輸入以下指令:
chmod +x build.sh

這樣子就可以改變它的屬性了。

前面的準備工作都做完了,接下來就可以編譯了,
把剛剛開啟的終端機輸入以下指令,
./build.sh
這時候就能看到有一堆字跑出來,
如果看到的字是這樣子的話
xcodebuild: error: SDK "iphoneos7.0" cannot be located.
這就要修改一開始的 IOSSDK_VER="7.0" 了,
現在的最新版本是 7.1,所以要將它改成 7.1。

最後如果有看到
** BUILD SUCCEEDED **
這個的話那就代表正常結束了,

這時候就能看到多了一個資料夾,
這裡面就能找到 GPUImage.framework,
另外在 Release-iphoneos 能找到 libGPUImage.a 這個檔案,
(如果你只要使用模擬器的話就去 Release-iphonesimulator 找)
這兩個就是要放入你的專案中的檔案。

這樣子準備工作就全部結束了,
下次開始就要教正式的使用了,
下次再見。

1 則留言:

peer 提到...

請問板主還有繼續開發app嗎?最近開始學習。過來爬文參觀哩!謝謝分享!