文章目錄

一、關於CocoaPods
     1、什麼是CocoaPods
     2、安裝使用CocoaPods
     3、pod install 和 pod update 區別
二、製作CocoaPods準備工作
     1、註冊Trunk賬號
     2、註冊github賬號
     3、安裝git
     4、配置git
     5、配置ssh key
 三、讓你的庫支援CocoaPods
    1、建立專案: repository 或 start a project
    2、填寫專案資訊
    3、clone專案到本地
    4、x-code建立專案並儲存到克隆的資料夾下面
    5、commit 並push 到github
    6、製作podspec,填寫規範
    7、驗證podspec正確性
    8、提交我們的開源專案到cocoapods
    9、編輯README檔案
    10、常見問題總結
 四、常用的git命令列
   1、倉庫
   2、配置
   3、增加、刪除檔案
   4、程式碼提交
   5、分支
   6、標籤
   7、檢視資訊
   8、遠端同步
   9、撤銷
五、git常見的GUI工具
   1、主要介紹sourceTree(對於git命令的封裝而已)
   2、git推薦教程
   3、git官網 https://git-scm.com/
 

一、關於CocoaPods

1、什麼是CocoaPods
CocoaPods管理X-code專案的庫依賴項。專案的依賴項在名為Podfile的單個文字檔案中指定。CocoaPods將解析庫之間的依賴關係，獲取生成的原始碼，然後在Xcode工作區中將它們連結在一起以構建專案。最終目標是通過建立更加集中的生態系統來提高第三方開源庫的可發現性和參與度。

2、安裝使用CocoaPods
CocoaPods是用Ruby構建的，它可以使用macOS上的預設Ruby進行安裝。您可以使用Ruby版本管理器(例如:rvm)。使用macOS上提供的標準Ruby即可。
具體使用教程戳這裡

3、pod install 和 pod update 區別

pod install
這是在您第一次要檢索專案的pod時使用，但每次編輯Podfile以新增，更新或刪除Pod時都會使用。每次pod install命令執行的時候，pod install會為每一個它安裝的pod庫在Podfile.lock檔案中寫入其版本號。Podfile.lock檔案追蹤每一個安裝的pod庫的版本號，並鎖定這些版本號。對於在Podfile.lock檔案中的pod庫，pod install會只下載Podfile.lock檔案中指定的版本，而不會去檢查這個庫是否有更新的版本。 對於不在Podfile.lock檔案中的pod庫，pod install會搜尋這個pod庫在Podfile檔案中指定的版本。

pod update 或 pod update [podName]
當你運行了pod update podName命令，CocoaPods會在不考慮Podfile.lock中版本的情況下試著去查詢podName的最新版本。pod update podName命令會將相應的pod更新到最新的版本。

二、製作CocoaPos

1、註冊Trunk賬號

pod  trunk register 郵箱  '使用者名稱' 
例如：pod trunk register [email protected] 'zhansan'

註冊成功後到郵箱進行確認

確認完成後，檢視個人資訊

pod trunk me 

3、安裝git

檢視是否安裝過git

git

安裝過則輸出

usage: git [--version] [--help] [-C <path>] [-c name=value]
           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
           [-p | --paginate | --no-pager] [--no-replace-objects] [--bare]
           [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
           <command> [<args>]

These are common Git commands used in various situations:

start a working area (see also: git help tutorial)
   clone      Clone a repository into a new directory
   init       Create an empty Git repository or reinitialize an existing one

work on the current change (see also: git help everyday)
   add        Add file contents to the index
   mv         Move or rename a file, a directory, or a symlink
   reset      Reset current HEAD to the specified state
   rm         Remove files from the working tree and from the index

examine the history and state (see also: git help revisions)
   bisect     Use binary search to find the commit that introduced a bug
   grep       Print lines matching a pattern
   log        Show commit logs
   show       Show various types of objects
   status     Show the working tree status

grow, mark and tweak your common history
   branch     List, create, or delete branches
   checkout   Switch branches or restore working tree files
   commit     Record changes to the repository
   diff       Show changes between commits, commit and working tree, etc
   merge      Join two or more development histories together
   rebase     Reapply commits on top of another base tip
   tag        Create, list, delete or verify a tag object signed with GPG

collaborate (see also: git help workflows)
   fetch      Download objects and refs from another repository
   pull       Fetch from and integrate with another repository or a local branch
   push       Update remote refs along with associated objects

'git help -a' and 'git help -g' list available subcommands and some
concept guides. See 'git help <command>' or 'git help <concept>'
to read about a specific subcommand or concept.

通過homebrew安裝git，先安裝homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安裝git

brew install git

4、配置git

檢視是否配置了

git config user.name
git config user.email

配置使用者名稱和郵箱

git config --global user.name "使用者名稱"
git config --global user.email "郵箱"

注意: 使用者名稱和郵箱是git提交程式碼時用來顯示你身份和聯絡方式的，並不是github使用者名稱和郵箱

5、配置ssh key

克隆的兩種方式 : https/ssh (ssh侷限於專案建立者或參與者)

git clone  https://xxx.git
git clone [email protected]:xxx.git

任何工程都可以使用https去clone,但是提交許可權只有當你是專案的所有者或參與者，你才具備提交許可權。每次push程式碼到遠端倉庫需要校驗userName和password，配置ssh後，就可以直接提交不校驗。

檢查電腦是否配置過ssh,以下兩個命令就是檢查是否已經存在 id_rsa.pub (公鑰)或 id_dsa.pub (私匙)檔案

cd ~/.ssh
ls

生成祕鑰對

ssh-keygen -t rsa -C '郵箱'   

連續回車，輸入2次密碼繼續回車即可

可以在使用者主目錄裡找到.ssh目錄，裡面有id_rsa和id_rsa.pub兩個檔案，這兩個就是SSH Key的祕鑰對，id_rsa是私鑰，不能洩露出去，id_rsa.pub是公鑰

開啟github，登入個人賬號，點選settting，點選ssh，如下圖

開啟公鑰檔案id_rsa.pub(直接拖進x-code)，全部複製

測試git是否與github繫結成功

ssh [email protected]

輸入密碼後回車

Hi  'github賬號的使用者名稱! ' You've successfully authenticated, 
but GitHub does not provide shell access.

至此git 與github繫結成功。

三、讓你的庫支援CocoaPos

1、建立專案: repository 或 start a project

2、填寫專案資訊

3、clone專案到本地
找到克隆路徑

開啟終端，cd到桌面，執行

git clone  路徑
例如 : git clone https://github.com/AFNetworking/AFNetworking.git

克隆完成桌面就有建立的工程

4、x-code建立專案並儲存到克隆的資料夾下面

5、commit 並push 到github

#進入到工程路徑
cd   專案拖進終端
# 檔案新增到倉庫(. 代表新增所有檔案)
git  add .
#檔案新增到倉庫
git commit -m "提交資訊"
#推送到遠端倉庫
git push

到此，你的專案就已經上傳到github上。

下面的步驟開始，是將你封裝的庫開源到github，讓別人pod你的封裝庫
6、製作podspec檔案，填寫規範

#進入到專案根目錄
cd 拖進終端
#新建一個字尾為.podspec檔案
pod spec create xxx （注意：xxx一般都是專案名） 

xxx.podspec可以直接拖進x-code開啟編輯

Pod::Spec.new do |s|

#專案名
  s.name         = "videoEdit"
#版本號
  s.version      = "0.0.1"
#版本號
  s.summary      = "A short description of videoEdit."
#專案描述
  s.description  = <<-DESC
#填寫專案描述
                   DESC
#github專案主頁
  s.homepage     = "http://EXAMPLE/videoEdit"
#效果圖，多張用逗號分隔開
  s.screenshots  = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"
#開源許可
  s.license      = "MIT (example)"
#作者資訊(可以以下4中格式)
  s.author             = { "Cherish" => "[email protected]" }
  # Or just: s.author    = "Cherish"
  # s.authors            = { "Cherish" => "[email protected]" }
  # s.social_media_url   = "http://twitter.com/Cherish"
#支援平臺相容的最新版本(可以以下2種格式)
  # s.platform     = :ios
  # s.platform     = :ios, "5.0"
#專案原始碼
  s.source       = { :git => "http://EXAMPLE/videoEdit.git", :tag => "#{s.version}" }
#專案原始碼目錄(即被pod封裝庫)
  s.source_files  = "Classes", "Classes/**/*.{h,m}"
  s.exclude_files = "Classes/Exclude"
#公開標頭檔案地址
  # s.public_header_files = "Classes/**/*.h"
#專案依賴的庫，多個庫用逗號分隔
  # s.framework  = "SomeFramework"
  # s.library   = "iconv"
  # s.libraries = "iconv", "xml2"
#要求ARC環境
  # s.requires_arc = true
#xcode裡的config檔案
  # s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
#依賴的其他倉庫，如果有多個需要填寫多個s.dependency
  # s.dependency "JSONKit", "~> 1.4"

end

例如,專案videoEdit的Lib實體資料夾下的檔案你已經封裝成庫，準備開源

根目錄下的videoEdit.podspec可以簡寫如下

Pod::Spec.new do |s|
  s.name         = "videoEdit"
  s.version      = "1.0.0"
  s.summary      = "視訊編輯demo"
  s.homepage     = "https://github.com/CoderYangFeiLong/videoEdit"
  s.license      = "MIT"
  s.author       = { "Cherish" => "[email protected]" }
  s.platform     = :ios
  s.source       = { :git => "https://github.com/CoderYangFeiLong/videoEdit.git", :tag => "1.0.0" } #這邊如果打了tag，遠端倉也需要打tag
  s.source_files  = "videoEdit/videoEdit/Lib/*.{h,m}"
  s.requires_arc = true
end

儲存後，將程式碼commit並push

git commit -m Release 1.0.0
git tag 1.0.0
git push --tags  
git push origin master

7、驗證podspec正確性

pod lib lint
或者 
pod lib lint --allow-warnings 

沒什麼大問題就會顯示通過了videoEdit passed validation.

8、提交我們的開源專案到cocoapods

 pod trunk push xxx.podspec
 例如: pod trunk push videoEdit.podspec

顯示通過Validating podspec

正常的pod search試試pod search xxx

我們來測試下，X-code隨意建立個project，TestDemo, 建立Podfile檔案，執行pod install

動手試試吧！

9、編輯README檔案

github上README.md的編寫，在大多數情況下與csdn的MarkDown編輯器一樣的，但是它回車不一樣,在README.md上用
代替回車。在不需要上傳圖片等資源時，基本上只需要注意回車即可。

關於標題

# 一級標題
## 二級標題
### 三級標題
注意：#和文字之間有個空格

關於粗體、斜體

**粗體**
*斜體*
***粗體加斜體***

關於程式碼塊（esc下面那個按鍵連續3下，成對出現）

關於表

|列名1|列名2|
|:---|:---|
|列1的內容1|列2的內容1|
|列1的內容2|列2的內容2|

效果如下

關於超連結

[描述文字](連結地址)
例如 :[百度](https://www.baidu.com/)

關於效果圖

我一般是將效果圖放工程裡，推到遠端倉庫，再呼叫圖片連結。
格式

![image](圖片地址)

如何獲取圖片連結:右鍵複製圖片地址

如何修改效果圖樣式

# 將圖片製成 200 *200 
<img src="圖片地址" width="200" height="200" alt="描述語言,寫什麼都不會顯示出來"/>
# 200*200，居中顯示
<div align=center><img width="200" height="200" src="圖片地址"/></div>

10、常見問題總結

(1) pod search過程中失敗, 或出現這類字樣

[!] Unable to find a pod with name, author, summary, or descriptionmatching ...

解決方案 : 可以通過重新建立索引來解決，再次搜尋時，會自動重新建立索引。

rm ~/Library/Caches/CocoaPods/search_index.json

(2) 在驗證podspecpod lib lint檔案發生的錯誤

 - ERROR | [iOS] file patterns: The `source_files` pattern did not match any file.

這個是在指定共享的類庫時, 檔案路徑不對, 也就是設定s.source_files 欄位時, 發生了錯誤。修改對了即可。

其他問題後續補充吧！

四、常用的git命令列

1、倉庫

# 在當前目錄新建一個Git程式碼庫
$ git init

# 新建一個目錄，將其初始化為Git程式碼庫
$ git init [project-name]

# 下載一個專案和它的整個程式碼歷史
$ git clone [url]

2、配置

# 顯示當前的Git配置
$ git config --list

# 編輯Git配置檔案
$ git config -e [--global]

# 設定提交程式碼時的使用者資訊
$ git config [--global] user.name "[name]"
$ git config [--global] user.email "[email address]"

3、增加、刪除檔案

# 新增指定檔案到暫存區
$ git add [file1] [file2] ...

# 新增指定目錄到暫存區，包括子目錄
$ git add [dir]

# 添加當前目錄的所有檔案到暫存區
$ git add .

# 新增每個變化前，都會要求確認
# 對於同一個檔案的多處變化，可以實現分次提交
$ git add -p

# 刪除工作區檔案，並且將這次刪除放入暫存區
$ git rm [file1] [file2] ...

# 停止追蹤指定檔案，但該檔案會保留在工作區
$ git rm --cached [file]

# 改名檔案，並且將這個改名放入暫存區
$ git mv [file-original] [file-renamed]

4、程式碼提交

# 提交暫存區到倉庫區
$ git commit -m [message]

# 提交暫存區的指定檔案到倉庫區
$ git commit [file1] [file2] ... -m [message]

# 提交工作區自上次commit之後的變化，直接到倉庫區
$ git commit -a

# 提交時顯示所有diff資訊
$ git commit -v

# 使用一次新的commit，替代上一次提交
# 如果程式碼沒有任何新變化，則用來改寫上一次commit的提交資訊
$ git commit --amend -m [message]

# 重做上一次commit，幷包括指定檔案的新變化
$ git commit --amend [file1] [file2] ...

5、分支

# 列出所有本地分支
$ git branch

# 列出所有遠端分支
$ git branch -r

# 列出所有本地分支和遠端分支
$ git branch -a

# 新建一個分支，但依然停留在當前分支
$ git branch [branch-name]

# 新建一個分支，並切換到該分支
$ git checkout -b [branch]

# 新建一個分支，指向指定commit
$ git branch [branch] [commit]

# 新建一個分支，與指定的遠端分支建立追蹤關係
$ git branch --track [branch] [remote-branch]

# 切換到指定分支，並更新工作區
$ git checkout [branch-name]

# 切換到上一個分支
$ git checkout -

# 建立追蹤關係，在現有分支與指定的遠端分支之間
$ git branch --set-upstream [branch] [remote-branch]

# 合併指定分支到當前分支
$ git merge [branch]

# 選擇一個commit，合併進當前分支
$ git cherry-pick [commit]

# 刪除分支
$ git branch -d [branch-name]

# 刪除遠端分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]

6、標籤

# 列出所有tag
$ git tag

# 新建一個tag在當前commit
$ git tag [tag]

# 新建一個tag在指定commit
$ git tag [tag] [commit]

# 刪除本地tag
$ git tag -d [tag]

# 刪除遠端tag
$ git push origin :refs/tags/[tagName]

# 檢視tag資訊
$ git show [tag]

# 提交指定tag
$ git push [remote] [tag]

# 提交所有tag
$ git push [remote] --tags

# 新建一個分支，指向某個tag
$ git checkout -b [branch] [tag]

7、檢視資訊

# 顯示有變更的檔案
$ git status

# 顯示當前分支的版本歷史
$ git log

# 顯示commit歷史，以及每次commit發生變更的檔案
$ git log --stat

# 搜尋提交歷史，根據關鍵詞
$ git log -S [keyword]

# 顯示某個commit之後的所有變動，每個commit佔據一行
$ git log [tag] HEAD --pretty=format:%s

# 顯示某個commit之後的所有變動，其"提交說明"必須符合搜尋條件
$ git log [tag] HEAD --grep feature

# 顯示某個檔案的版本歷史，包括檔案改名
$ git log --follow [file]
$ git whatchanged [file]

# 顯示指定檔案相關的每一次diff
$ git log -p [file]

# 顯示過去5次提交
$ git log -5 --pretty --oneline

# 顯示所有提交過的使用者，按提交次數排序
$ git shortlog -sn

# 顯示指定檔案是什麼人在什麼時間修改過
$ git blame [file]

# 顯示暫存區和工作區的差異
$ git diff

# 顯示暫存區和上一個commit的差異
$ git diff --cached [file]

# 顯示工作區與當前分支最新commit之間的差異
$ git diff HEAD

# 顯示兩次提交之間的差異
$ git diff [first-branch]...[second-branch]

# 顯示今天你寫了多少行程式碼
$ git diff --shortstat "@{0 day ago}"

# 顯示某次提交的元資料和內容變化
$ git show [commit]

# 顯示某次提交發生變化的檔案
$ git show --name-only [commit]

# 顯示某次提交時，某個檔案的內容
$ git show [commit]:[filename]

# 顯示當前分支的最近幾次提交
$ git reflog

8、遠端同步

# 下載遠端倉庫的所有變動
$ git fetch [remote]

# 顯示所有遠端倉庫
$ git remote -v

# 顯示某個遠端倉庫的資訊
$ git remote show [remote]

# 增加一個新的遠端倉庫，並命名
$ git remote add [shortname] [url]

# 取回遠端倉庫的變化，並與本地分支合併
$ git pull [remote] [branch]

# 上傳本地指定分支到遠端倉庫
$ git push [remote] [branch]

# 強行推送當前分支到遠端倉庫，即使有衝突
$ git push [remote] --force

# 推送所有分支到遠端倉庫
$ git push [remote] --all

9、撤銷

# 恢復暫存區的指定檔案到工作區
$ git checkout [file]

# 恢復某個commit的指定檔案到暫存區和工作區
$ git checkout [commit] [file]

# 恢復暫存區的所有檔案到工作區
$ git checkout .

# 重置暫存區的指定檔案，與上一次commit保持一致，但工作區不變
$ git reset [file]

# 重置暫存區與工作區，與上一次commit保持一致
$ git reset --hard

# 重置當前分支的指標為指定commit，同時重置暫存區，但工作區不變
$ git reset [commit]

# 重置當前分支的HEAD為指定commit，同時重置暫存區和工作區，與指定commit一致
$ git reset --hard [commit]

# 重置當前HEAD為指定commit，但保持暫存區和工作區不變
$ git reset --keep [commit]

# 新建一個commit，用來撤銷指定commit
# 後者的所有變化都將被前者抵消，並且應用到當前分支
$ git revert [commit]

暫時將未提交的變化移除，稍後再移入
$ git stash
$ git stash pop

五、git常見的GUI工具

1、主要介紹sourceTree(對於git命令的封裝而已)

還沒想好怎麼寫…