本節介紹cocos2d的下載下傳與安裝。如果想使用cocos2d開發iphone應用或遊戲,首先要下載下傳cocos2d的模闆,然後安裝該模闆,最後建立cocos2d**的幫助文檔。下面分别來介紹這幾個步驟。
1.2.1 下載下傳cocos2d**
首先登入cocos2d的官方網站:<code>http://www.cocos2d-iphone.org</code>,切換到download選項,可以看到如圖1-2所示的網站頁面。
由圖1-2可以看到,cocos2d的最新穩定版本有v1.0.1和v2.0版。考慮到cocos2d v2.0版本支援衆多的新特性,同時也是今後官方主力維護的版本(1.x版本留給社群更新,而引擎的主力開發者ricardo quesada将主要負責cocos2d v2.0及其後續版本的更新與維護),本書将直接使用最新的v2.0版本。直接單擊“cocos2d-iphone-2.0.tar.gz”這個連結就可以開始下載下傳了。
如果要下載下傳cocos2d之前的版本,則可以在浏覽器中輸入以下連結:<code>https://github.com/cocos2d/cocos2d-iphone/tags</code>。
當然,這隻是其中一種方式,在這裡,我們向大家推薦一種更加友善的做法,那就是使用git。git和svn一樣,也是一款源代碼管理工具,它和svn最大的差別就是:git是分布式的,而svn是集中式的。具體的差別大家可以通過google檢視,建議大家深入學習一下。為什麼要使用git呢?首先,cocos2d目前放在github上面托管,全世界所有的開發者都可以非常友善地從github上面擷取到cocos2d的最新開發進展的源代碼,同時可以向該項目貢獻源代碼。
使用git之前,首先我們需要安裝git。大家首先在浏覽器中打開位址<code>http://code.google.com/p/git-osx-installer/downloads/list</code>,然後下載下傳最新版本安裝即可。如圖1-3所示。

安裝完成之後,需要打開mac os x中的終端程式(terminal),然後在裡面輸入“git clone git://github.com/cocos2d/cocos2d-iphone.git”就可以了。這句指令的意思是把cocos2d的源代碼倉庫從遠端伺服器上複制一份放在本地機器上面。等進度完成100%之後,輸入“cd cocos2d-iphone”,然後通過“ls”指令,就可以在終端裡列出所有與cocos2d相關的檔案。
注意 git裡面有一個分支的概念,第一次複制過來的版本倉庫,預設在master分支上面。而此分支的作用就是釋出項目目前的穩定版本。從cocos2d官網可知,目前的穩定版本是cocos2d-iphone-1.01。因為本書将以cocos2d v2.0版本為藍本,是以需要切換到cocos2d v2.0分支上面去。
切換到cocos2d v2.0隻需要一條簡單的指令,即在終端裡面輸入“git checkout master-v2”。因為現在cocos2d的1.x版本已經到1.1了,是以如果大家想獲得1.1版本,可以在終端裡面輸入“git checkout master”。
注意,cocos2d 1.x版本和2.x版本的項目模闆是可以共存的,當使用xcode建立新項目的時候,可以在左邊的項目模闆中同時看到1.x和2.x的模闆,如圖1-4所示。
1.2.2 安裝 cocos2d 模闆
在安裝cocos2d模闆之前,首先確定自己的系統上已經安裝了xcode,否則請先安裝最新版本的xcode。本書中使用的作業系統是最新的mac os 10.8.1,開發工具是xcode 4.4.1。
開發環境搭好之後我們就可以擷取cocos2d v2.0的源代碼了。如果是使用直接下載下傳壓縮包的方式,隻需要在下載下傳完之後解壓縮到documents目錄。如果是使用git的方式擷取的源代碼,則記得一定要切換到master-v2分支上。然後找到terminal工具(application→utilities→terminal,如圖1-5所示)。
打開terminal工具,通過“cd documents”指令進入documents目錄,通過“ls”指令列出目前目錄,然後再通過“cd cocos2d-iphone”指令進入源代碼所在根目錄,通過指令“ ./install-templates.sh-u-f”安裝,如圖1-6所示(如果使用的是git的方式,則直接輸入“git checkout master-v2”指令之後,輸入“./install-templates.sh-u-f”指令就可以安裝cocos2d v2.0的模闆了)。
但如果并非首次安裝cocos2d,有時會在terminal中顯示很多權限錯誤,如圖1-7所示。
此時應打開finder,選擇“go to”,然後選擇“go to folder”,輸入之前儲存cocos2d模闆的路徑,如圖1-8所示。
在templates子目錄下建立cocos2d v2.x和file templates兩個子目錄,并在file templates子目錄下建立cocos2d v2.x目錄,如圖1-9所示。
再次回到terminal,輸入“./install-templates.sh-u-f”,此時會提示順利安裝,如圖1-10所示。
注意 使用的使用者需要設定密碼,如果沒有設定密碼,請到“系統設定”-“使用者”裡去設定。
那麼,如果要删除cocos2d之前的版本,該如何處理呢?很簡單,隻需打開finder,選擇“go to”,選擇“go to folder”,然後輸入之前儲存cocos2d模闆的路徑,并删除templates中的所有内容即可。
1.2.3 建立cocos2d-iphone的幫助文檔
cocos2d中的api不屬于蘋果官方提供,是以,在預設情況下,xcode的幫助文檔中無法查到cocos2d中的api幫助資訊。為了友善學習和使用cocos2d中所提供的api,可以通路cocos2d官方提供的線上文檔。
除此之外,還有一種方法可以非常友善地擷取最新的api文檔,那就是使用dash工具。dash是一款集api文檔浏覽和代碼片斷管理于一體的工具,它支援ios、android、cocos2d、unity等20多種架構或語言的文檔浏覽功能。最重要的是,這些文檔會随時得到更新,隻需要更新相應的更新包即可。雖然這款軟體不是免費的,想要使用其完整的功能必須購買才行。不過,其免費版本并不妨礙我們把它當作文檔查詢工具來使用。
要使用dash,首先必須下載下傳。下載下傳過程其實非常簡單,隻需要打開app store,在搜尋裡面輸入dash關鍵字,在查詢的結果中找到圖1-11所示的程式icon。單擊下載下傳安裝即可。
安裝完dash之後,需要安裝cocos2d的文檔集。首先,打開dash的“應用程式偏好設定”,并切換到downloads标簽,如圖1-12所示。
安裝好cocos2d的文檔包之後我們再打開dash,這時在左上角的搜尋框内輸入ccsprite,此時會得到如圖1-13所示輸出(免費版本字型顯示紅色)。
1.2.4 使用cocos2d中内置的項目
安裝了cocos2d之後不要錯過其中内置的項目,如果認真研究,大家可以從中學到很多知識,了解到更多有關cocos2d的強大功能。
從finder中找到documents,進入cocos2d-iphone目錄,打開cocos2d-ios.xcodeproj檔案,如圖1-14所示。
我們可以看到其中有多個target,可以選擇不同的target逐一編譯運作,體驗cocos2d的強大功能,如圖1-15所示。
在了解cocos2d的基礎知識後,我們還可以随時打開這個工程,檢視每種測試的詳細代碼,進而更深入地學習cocos2d。
學習使用cocos2d中内置的模闆,是從入門到精通的必經之路。