iOS 項目的搭建到分發
本文主要介紹每當開啟一個新項目的第一步:從項目的搭建到給團隊分發模塊開始開發的過程。現在虛擬一個即將要開始的項目叫:NewStart(新起點),通過這個項目你能看到整個項目的目錄結構。
主要的框架設計如下 :
建議先下載已經完成的代碼,其實可以直接看代碼的,可以不用看這篇文章,這裏說的不全,其中也有很多的廢話,我的表述也有些問題。畢竟一行代碼勝過千言萬語。下載代碼下來之後,在運行之前記得 pod install 一下。由於代碼有更新,所以本文介紹主要是在git的第二個節點做介紹的:項目第一次提交,主要完成了項目的搭建到分發。
接下來、將會按照步驟依次做介紹。
一、git準備
剛開始工作那會一直使用svn來做代碼管理,自17年初開始使用git、這次使用 github 來做介紹。一般情況公司都會有自己的 git 服務器。具體的步驟:
1、首先需要有一個項目組 (group),一般是以公司為單位。比如 XXXX 公司的項目,都應該在一個組中。即使這個公司只有一個項目,也應該是單獨的一個組。
2、在指定的項目組中創建一個項目,一個空的沒有任何分支的 git 項目已經完成。
3、通過第2步創建的 git 項目,可以直接在網頁把 README.md 文件也創建了。
4、將項目 clone 到本地,然後添加一個忽略文件 (.gitignore)
以上是在工作中的 git 的常規步驟,現在使用 github 的流程走一遍,流程是一致的,唯一的區別是一個 group ,一個叫 team,其實都是一樣的。
在自己的賬號中創建一個 team:
這是 team 創建成功的樣子。
開始創建項目 :
這是項目創建成功的樣子:
現在為止,一個 git 遠程倉庫就準備好了,我們直接 clone 到本地,最終是這樣子的:
到現在為止,一個 git 的全部準備工作就全部完成了。其實這個過程是很簡單的,可以說不需要時間就能完成。
二、創建項目
在Xcode中創建完項目後是這樣子的:
首當其沖的將項目的系統最低支持版本也改一下:
到現在為止,一個簡單的項目就算是結束了,現在就可以提交遠程給同事們開始開發了麽?那肯定是不可以的,還差得很遠,現在只是有一個項目,還需要將一個簡單的框架搭建好才能給出去,否則其他同事是會很亂的。至少還需要把一下3點
完成 :
1、項目的整體結構以及常用的基類
2、 第三方
3、 網絡框架
這三點可以不是最終版本,但是一定要有,畢竟團隊合作開發肯定得有一個方向,否則不同的人肯定會弄出自己的一套,這樣是不行的。下面根據以上3點分別做介紹。
1、項目的整體結構以及常用的基類
目錄小改動
添加 SupportingFiles 目錄
在新版本的 Xcode 中沒有 SupportingFiles 了,但是習慣了這個文件,我們可以自己搞一個。主要是習慣了將 Assets.xcassets, Info.plist 與 main.m 這三個文件放到這個目錄下。
這裏需要註意的是,要在文件中將 project.pbxproj 文件中的 INFOPLIST_FILE 的值改一下,因為改了 Info.plist 文件的路徑。
添加 AppDelegate 目錄
將 AppDelegate 的兩個 .h 與 .m文件單獨放到這個文件夾中。
現在的樣子是這樣的:
在 Xcode 中,目錄合起來是這個樣子的:
這樣看起來還是比較簡單明了清楚的,我感覺,其實到現在為止,只是做了一個小小的調整而已,還沒有真正的搭建項目的結構。
添加 General 目錄
這個目錄是一個核心的目錄,所有的代碼都將會在這裏。這個目錄中也有這些的目錄:Libs(用到的非 pod 管理的第三方庫),Category (分類),Modules (項目的所有模塊),Macro(基本的配置,比如網絡,基類)。如:
其實在上面的目錄中的 Libs 與 Category 是可以允許為空文件的,具體可以在開發的過程中用到了再添加。但是Modules與Macro 盡量一次性弄好。
Macro目錄完善
在這個目錄中,一般存放的是固定的,以後即使要改的話,改動也不會太大的東西,或者即使要改也是全局性修改的那種。最終結果如下:
其實,穿過圖片就能知道這裏面寫的都是一些再基礎不過的基本配置。換句話來說,幾乎所有的項目都能通用,即使改動也不會太大。
Modules目錄完善
這個目錄中,就是項目的核心需求了。具體要怎麽去搭建目錄,那就要看項目的實際結構了。
比如這樣的:
2、 第三方
通常都會使用 CocoaPods 來管理第三方代碼。
是這樣的 :
或者是直接將別人的代碼直接拖入項目中,是這樣的:
3、 網絡框架
網絡框架,為什麽一定要先提前弄好?
反正在我剛開始敲代碼那會兒,我們的新項目是沒有的,然後團隊中的每個人各領風騷,本來一個項目的網絡請求都應該是一個套路的,否則最後會很亂的。
同事們在使用的時候,直接在這裏來添加自己的接口即可:
通過自己的模塊/功能自行創建分類,這樣項目不會至於會亂。
到現在為止,一個簡單的項目搭建就算完成了,可以直接將自己本地的代碼提交到遠程,告知團隊開始進行開發了。記得創建一個 develop 分支。
直接在這裏下載 代碼代碼代碼,下載代碼下來之後,在運行之前記得 pod install 一下。由於代碼有更新,所以本文介紹主要是在git的第二個節點做介紹的:項目第一次提交,主要完成了項目的搭建到分發.
iOS 項目的搭建到分發