《Coding iOS 客户端》源码阅读笔记-Part1

Coding iOS 客户端已开源很久了,相信很多自觉学习的同学们都已经看完这个工程,而我呢,稍微懒了点,从今天开始才去阅读。初衷是希望学习到有经验的前辈们对项目搭建技巧或开发常见规矩等,让今天的自己比昨天的自己好一点就好。开始吧……

在 Coding iOS 项目的 github 界面介绍页面赫然有一个提醒:


《Coding iOS 客户端》源码阅读笔记-Part1_第1张图片

这个一定是导入项目依赖库的脚本,因为咱也是有经验的不是。

开始将大象拉过来……

  1. 首先我们通过 github 客户端按照上README 上的描述将项目 clone 到本地。
  2. 打开工程文件夹,双击运行 bootstrap 脚本。


    《Coding iOS 客户端》源码阅读笔记-Part1_第2张图片

    运行脚本期间我碰到的坑是:
    脚本运行报错

    *** Downloading objective-git.framework binary at "0.12.0"
    *** Skipped installing objective-git.framework binary due to the error:
    "GitHub API request failed: networkError(Error Domain=NSURLErrorDomain........
    
    但是可能脚本运行完了还是会自动帮你打开工程,那么你在这样的情况下运行项目的话Xcode 会报下属的 Error:
    “ObjectiveGit/ObjectiveGit.h” file not found
    
    其实,我这边就是因为网络不佳情况进行库的依赖下载的,期间最好先翻墙。如果再有上述情况的话,将整个库删除,在重新 clone 一次和 双击脚本运行脚本(我就是删除库重新执行上述两步成功的)。

神奇的 bootstrap 脚本都做了什么?

内容一览


《Coding iOS 客户端》源码阅读笔记-Part1_第3张图片
  1. #!/bin/bash 指定脚本解释器,这里是用/bin/bash做解释器的,bash 是Mac 默认的解析器。其中“#!”是一个约定的标记,它告诉系统这个脚本需要什么解释器来执行。

  2. CMD_PATH=dirname $0 定义一个名叫CMD_PATH的变量,而dirname $0字符串指的是脚本文件放置的目录,一般可以根据这个目录来定位所要运行程序的相对位置(绝对位置除外)(这里因为md原因,将dirname $0的单引号去掉)

  3. cd $CMD_PATH 进入到脚本所在目录里

  4. cp Coding_iOS/Coding_iOS-Prefix.pch.example Coding_iOS/Coding_iOS-Prefix.pch将Coding_iOS目录下的Coding_iOS-Prefix.pch.example源文件 复制到(或覆盖,如果目标文件已存在则使用源文件覆盖目标文件)Coding_iOS目录下的Coding_iOS-Prefix.pch目标文件
    cp 解析:

    《Coding iOS 客户端》源码阅读笔记-Part1_第4张图片

  5. git submodule update --init --recursive git 子模块的更新或拉取对应代码(这个没用过不知道,待续解析~)

  6. pod install 按照Podfile.lock文件里所指定库的版本号下载安装依赖库(Install project dependencies according to versions from a Podfile.lock)

    《Coding iOS 客户端》源码阅读笔记-Part1_第5张图片

  7. carthage update 更新和重建项目依赖(Update and rebuild the project's dependencies)

  8. open Coding_iOS.xcworkspace 通过Coding_iOS.xcworkspace打开工程。

  9. exit 0 退出当前脚本程序

怎样去生成这样一个双击即可运行的脚本文件?(以创建clickexe.sh脚本为例)

  1. 首先创建测试脚本
touch clickexe.sh
open -e clickexe.sh
  1. 在脚本中输入内容
echo "hello world"

echo 解析:

《Coding iOS 客户端》源码阅读笔记-Part1_第6张图片

  1. 退出脚本编辑后回到终端在当前脚本路径下,再执行命令
chmod +x clickexe.sh

chmod +x clickexe.sh是指对clickexe.sh脚本增加执行权限。也就是说让该文件在被双击后会按照脚本内的第一行描述去寻找到指定的解析器,然后运行脚本后面的命令。

  1. 我们发现,自己写的clickexe.sh脚本是有后缀的,而 bootstrap 这个没有,那是否没有后缀也可以的呢?答案是,是的。
    其中 clickexe.sh的扩展名为sh(sh代表shell),扩展名并不影响脚本执行,见名知意就好,如果你用php写shell 脚本,扩展名就用php好了。
    综上步骤,我们双击运行clickexe.sh脚本,即可看到终端bash 解析器上输出hello world;


    《Coding iOS 客户端》源码阅读笔记-Part1_第7张图片

小结一下:

通过使用脚本省去了每次都要在终端按步骤敲下依赖下载的命令动作,让新手的快速布建项目。毕竟有时候这些命令或者步骤流程还真是会容易让人给忘记。大家不妨都试一试这个小技巧吧~

Ref

Git Submodules reference:

Git Submodule 用法筆記
Git 工具 - 子模块
git的submodule功能详解

Shell Ref

Shell脚本编程30分钟入门
Coldfunction的知识库
Shell Scripting Primer
高级Bash脚本编程指南中文版(原著Revision10)
$ cd dirname $0
创建双击可执行的sh脚本
chmod 命令

你可能感兴趣的:(《Coding iOS 客户端》源码阅读笔记-Part1)