分类（Category）

1. 分类的应用：

• 声明私有方法
• 分解体积庞大的类文件
• 把Framework的私有方法公开

2. 分类的特点（或者说与扩展的区别）：

• 运行时决议：在编写完分类文件后，并没有直接把分类内容添加到相关的宿主类上。而是在运行时使用runtime把分类的内容添加到宿主类上。
• 可以为系统类添加分类

3. 分类的优、缺点：

优点：

• 不需要通过增加子类而增加现有类的行为(方法),且类目中的方法与原始类方法基本没有区别
• 通过类目可以将庞大一个类的方法进行划分,从而便于代码的日后的维护、更新以及提高代码的阅读性

缺点：

• 无法向类目添加实例变量,如果需要添加实例变量,只能通过定义子类的方式
• 类目中的方法与原始类以及父类方法相比具有更高优先级,如果覆盖父类的方法,可能导致super消息的断裂。因此,最好不要覆盖原始类中的方法

4. 分类加载流程：

在运行APP的时候，加载完动态链接库，会加载可执行文件，通过runtime生成类、成员变量、方法列表，在宿主类的方法列表生成完之后，会开始加载分类的方法列表。

取到所有分类的列表数组（按编译时的顺序排序），然后按倒序从分类列表里取出每个分类的方法列表，生成一个二维数组。

把二维数组中的方法，按正序即从0索引开始，放入到宿主类的方法列表中（一维的数组）。
所以分类才拥有了“覆盖”原有类的方法功能，其实是原方法是存在的，只是分类的方法列表加入到了原有类的方法数组的前边，获得优先执行权。

5. 分类中都可以添加哪些内容：

• 增加实例方法
• 增加类方法
• 增加协议
• 增加实例属性。在分类中定义了一个属性，实际上只声明了对应的get方法和set方法，并没有在分类中添加实例变量 var
• 增加实例变量（使用runtime关联对象技术来添加）⚠️

在编译时候，分类会被编译成一个category_t的结构体，储存如下信息：

1
2
3
4
5
6
7
8

struct category_t {
    const char *name;                           分类名称
    classref_t cls;                             该分类所属的宿主类
    struct method_list_t *instanceMethods;      实例方法列表
    struct method_list_t *classMethods;         类方法列表
    struct protocol_list_t *protocols;          协议列表
    struct property_list_t *instanceProperties; 实例属性列表
}

6. 分类添加过程：

在程序运行时候，runtime会把分类的实例方法等信息合并到类对象的实例方法列表中，会把分类的类方法合并到元类对象的类方法列表中。

以添加实例方法为例：
运行时候，会遍历分类列表，拿到每一个分类的实例方法列表

1
2

分类1的实例方法列表 array1 [method_t, method_t]
分类2的实例方法列表 array2 [method_t, method_t]

然后根据获取到的所有分类的实例方法列表数 和 原宿主类的实例方法列表，重新分配内存，数据结构为一个新的二维数组

1

new_array [所有分类的实例列表数目 + 宿主类的实例列表数][]

最后把宿主类的实例列表移动都数组后面，并把所有分类的实例列表加入到新申请的二维数组的前边

1
2
3
4
5

[
array1,
array2.
[原宿主类的实例方法列表]
]

7. 加载调用栈：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

#系统库libSystem的Runtime入口函数
void _objc_init(void)
  
#处理由dyld映射的镜像
void map_images(unsigned count, const char * const paths[],const struct mach_header * const mhdrs[])
void map_images_nolock(unsigned mhCount, const char * const mhPaths[],const struct mach_header * const mhdrs[])
  
#读取镜像
void _read_images(header_info **hList, uint32_t hCount, int totalClasses, int unoptimizedTotalClasses)
  
#重新编译当前类的方法列表
static void remethodizeClass(Class cls)
  
#将方法列表以及属性和协议从类别附加到类。
static void attachCategories(Class cls, category_list *cats, bool flush_caches)

关联对象

1. 关联对象技术： 可以给分类添加成员变量

1
2
3
4
5
6
7
8

#关联对象: 使用objc_setAssociatedObject函数可以给某个对象关联其他的对象。
void objc_setAssociatedObject(id object, const void *key, id value, objc_AssociationPolicy policy)
 
#获取关联的对象: 使用objc_getAssociatedObject函数可以通过键来取出某个对象的关联对象。
id objc_getAssociatedObject(id object, const void *key)
 
#移除关联的对象:使用objc_removeAssociatedObjects函数可以移除某个对象身上的所有关联的对象。
void objc_removeAssociatedObjects(id object)

⚠️ 注意：
void objc_removeAssociatedObjects(id object)函数移除的是某个对象身上的所有关联的对象。
Objective-C 没有给我们提供移除对象身上单个关联对象的函数，所以，我们一般通过objc_setAssociatedObject 函数传入 nil 来达到移除某个关联对象的目的：

1
2
3
4
5
6
7
8
9
10

void objc_setAssociatedObject(object, key, nil, policy);

key：    要保证全局唯一，key与关联的对象是一一对应关系，必须全局唯一
value：  要关联的对象
policy： 关联策略。有五种关联策略
OBJC_ASSOCIATION_ASSIGN   等价于   @property(assign)
OBJC_ASSOCIATION_RETAIN_NONATOMIC   等价于   @property(strong, nonatomic)
OBJC_ASSOCIATION_COPY_NONATOMIC   等价于   @property(copy, nonatomic)
OBJC_ASSOCIATION_RETAIN   等价于   @property(strong,atomic)
OBJC_ASSOCIATION_COPY   等价于   @property(copy, atomic)

2. 常见问题：

问：关联对象技术给分类添加的成员变量放在了哪里？
答：关联对象由AssociationsManager管理并在AssociationsHashMap存储。所有对象的关联内容都在同一个容器中。

问：怎样清除某一个关联对象被关联的值？
答：setAssociatedObject方法中value值设为nil即可。

扩展（Extension）

1. 扩展的应用：

• 声明私有属性
• 声明私有方法
• 声明私有成员变量

2. 扩展的特点：

• 编译时决议
• 只以声明的形式存在，多数情况下寄生于宿主类的.m实现文件中
• 不能为系统类添加拓展

协议和代理

1. 代理的特点：

• 软件设计模式，代理模式
• 传递方式一对一

通知

1. 通知的特点：

• 是使用观察者模式来实现的用于跨层传递消息的机制
• 传递方式⼀对多

2. 通知的流程：

1

发送者 >  通知中心 > 多个观察者

3. 通知的实现机制

1

Notification_Map(notificationName: [observers])

KVO

1. 什么是KVO：

• 观察者设计模式的⼜一实现
• 使用isa-swizzling来实现KVO

2. isa-swizzling实现方式：

当我们调用了 addobvser 之后，系统会动态的⽣成一个NSKVONotifying_A类，并用 A 类的isa指针指向它，NSKOVNotifying_A是 A 的子类，为了重写 setter ⽅法，以达到通知的功能

3. 通过 KVC 设置 Value 能否生效?

系统在调用KVC赋值的时候，会先查找某一个变量是否有setter⽅法，如果有就会调用setter方法，如果没有，才会直接对成员变量直接赋值。所以，在调用setter⽅法的时候，KVO是生效的

4. 通过成员变量直接赋值Value能否生效?

直接赋值KVO是不会生效的，但是可以在赋值的时候手动调用 willChangeValueForKey 和didChangeValueForKey 达到 KVO 通知的效果

KVC

1. 是否会破坏⾯向对象编程思想：

setValueForKey 中的 key 是没有任何限制的，如果当用户知道某个对象里面私有成员变量量的key，就可以通过key对私有变量赋值或者访问，从这个⻆角度看，是破坏⾯面向对象编程思想的

2. 访问器器⽅方法判断规则：

1
2
3

<getKey>
<key>
<isKey>

3. 成员变量量判断规则：

1
2
3
4

_key 
_isKey
key
isKey

属性关键字

1. 深拷贝和浅拷贝的区别：

• 是否开辟新的内存空间
• 是否影响了引⽤用计数

前言

最近提审新项目时，构建包传到 iTunes Connect 后台后总是无法处理成功，Apple 邮件给出以下反馈：

1
2

ITMS-90809: Deprecated API Usage – Apple will stop accepting submissions of apps that use UIWebView APIs . See https://developer.apple.com/documentation/uikit/uiwebview
for more information.

由于早期已经将项目中的 UIWevView 全部替换为了 WKWebView ，于是推测可能是其他的第三方库里用到了 UIWevView ，所以逐个第三方的排查、升级SDK，最终还是无法解决问题。

于是推测可能是 Unity 框架中使用到了 UIWevView，于是用了以下命令扫描工程目录下的相关文件：

1

grep -r UIWebView .

扫描的结果是：

1

Binary file ./Libraries/libiPhone-lib.a matches

发现 libiPhone-lib.a 中引用了 UIWebView

解决方案

通过查找资料了解到，虽然 Unity 官方不准备在旧版本修复此问题，但是在问题描述中阐述了具体细节：在 PlatformDependent/iPhonePlayer/URLUtility.mm 中使用 UIWebView 处理游戏内链接。

因此，目前有两种解决方案：

1. 升级Unity引擎
2. 去掉 libiPhone-lib.a 中的 UIWebView 引用

Unity 已经在部分新版本中修复了这个问题，通过查阅 Release Notes 可以看到说明，但是升级游戏引擎的工作量比较大，所以没有被我们选为首选方案。

处理过程

1.创建URLUtility.mm

新建文件 URLUtility.mm，并写入下面代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

#include <iostream>
#import <UIKit/UIKit.h>

using namespace std;
namespace core {
    template <class type>
    class StringStorageDefault {};
    template <class type,class type2>
    class basic_string {
    public:
        char * str;
        basic_string( char* arg){
            str = arg;
        }
    };
}

void OpenURLInGame(core::basic_string< char,core::StringStorageDefault<char> > const&arg){}

void OpenURL(core::basic_string<char,core::StringStorageDefault<char> >const &arg){
    const void *arg2 = arg.str;
    UIApplication *app = [UIApplication sharedApplication];
    NSString *urlStr = [NSString stringWithUTF8String:(char *)arg2];
    NSURL *url = [NSURL URLWithString:urlStr];
    if (@available(iOS 10.0, *)) {
        [app openURL:url options:@{UIApplicationOpenURLOptionsSourceApplicationKey : @YES} completionHandler:nil];
    } else {
        [app openURL:url];
    }
}


void OpenURL(std::string const&arg){
    UIApplication *app = [UIApplication sharedApplication];
    NSString *urlStr = [NSString stringWithUTF8String:arg.c_str()];
    NSURL *url = [NSURL URLWithString:urlStr];
    if (@available(iOS 10.0, *)) {
        [app openURL:url options:@{UIApplicationOpenURLOptionsSourceApplicationKey : @YES} completionHandler:nil];
    } else {
        [app openURL:url];
    }
}

2.查看 libiPhone-lib.a 架构

用以下命令查看：

1

file libiPhone-lib.a

结果如下：

1
2
3
4

libiPhone-lib.a: Mach-O universal binary with 3 architectures: [arm_v7:current ar archive] [arm_v7s]
libiPhone-lib.a (for architecture armv7):current ar archive
libiPhone-lib.a (for architecture arm64):current ar archive
libiPhone-lib.a (for architecture armv7s):current ar archive

可以得出，有三种架构：armv7、arm64、armv7s。
因此在编译时建议三种架构都编译，否则在替换时会提示缺失符号问题。

3.构建URLUtility.o

使用以下命令构建：

1
2
3
4
5
6
7
8

# arm64 架构
clang -c URLUtility.mm -arch arm64 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk -o ./arm64/URLUtility.o

# armv7 架构
clang -c URLUtility.mm -arch armv7 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk -o ./armv7/URLUtility.o

# armv7s 架构
clang -c URLUtility.mm -arch armv7s -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk -o ./armv7s/URLUtility.o

注意：-isysroot

指定的 SDK 路径一定是当前工程使用的 Xcode 版本，特别是当机器上存在多个 Xcode 版本时要注意。

4.拆分 libiPhone-lib.a

使用以下命令：

1
2
3
4
5
6
7
8

# arm64 架构
lipo libiPhone-lib.a -thin arm64 -output ./arm64/libiPhone-lib.a

# armv7 架构
lipo libiPhone-lib.a -thin armv7 -output ./armv7/libiPhone-lib.a

# armv7s 架构
lipo libiPhone-lib.a -thin armv7s -output ./armv7s/libiPhone-lib.a

5.替换各个架构下的 libiPhone-lib.a 中的 URLUtility.o

使用以下命令：

1
2
3
4
5
6
7
8
9
10
11

# arm64 架构
ar -d ./arm64/libiPhone-lib.a URLUtility.o
ar -q ./arm64/libiPhone-lib.a ./arm64/URLUtility.o

# armv7 架构
ar -d ./armv7/libiPhone-lib.a URLUtility.o
ar -q ./armv7/libiPhone-lib.a ./armv7/URLUtility.o

# armv7s 架构
ar -d ./armv7s/libiPhone-lib.a URLUtility.o
ar -q ./armv7s/libiPhone-lib.a ./armv7s/URLUtility.o

6.合并 libiPhone-lib.a

使用以下命令：

1

lipo -create ./arm64/libiPhone-lib.a ./armv7/libiPhone-lib.a ./armv7s/libiPhone-lib.a -output libiPhone-lib.a

7.检查 libiPhone-lib.a

用以下命令检查新生成的 libiPhone-lib.a 文件：

1

grep -r UIWebView .

没有任何输出表示当前的文件中已经没有了 UIWebView 引用。

尾声

做完上述操作，将新的 libiPhone-lib.a 替换原工程的 libiPhone-lib.a ，再次提包，构建包成功处理完成。

上述过程已经写成了脚本，有需要的朋友可以自取。

传送门：
libiPhone-lib.sh

mac自带的sed和linux表现不一致

需要安装 gnu-sed, 推荐 Homebrew 安装

1
2
3
4
5
6
7
8
9
10
11

# 安装gnu-sed
brew install gnu-sed

# 编辑zsh配置文件
vi ~/.zshrc

# 设置PATH
export PATH="/usr/local/opt/gnu-sed/libexec/gnubin:$PATH"

#更新配置
source ~/.zshrc

再试，就可以了！

1
2
3
4
5

echo "a,b,c,d" |sed  's/,/\n/g'
a
b
c
d

npm换源

更换镜像即可解决，以淘宝的镜像为例：

1. 临时使用

1

npm --registry https://registry.npm.taobao.org install express

验证是否成功

1

npm info express

2. 持久使用

1

npm config set registry https://registry.npm.taobao.org

验证是否成功

1

npm config get registry

3. 恢复使用官方镜像

1

npm config set registry https://registry.npmjs.org

pip换源

国内的一些源：

1. 临时使用

在使用pip的时候在后面加上-i参数，指定pip源，例如：

1

pip install scrapy -i https://pypi.tuna.tsinghua.edu.cn/simple

2.永久修改

修改 ~/.pip/pip.conf (没有就创建一个)， 内容如下：

1
2

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

mac 安装Homebrew报错

安装Homebrew时有时会出现：

1

Failed to connect to raw.githubusercontent.com port 443: Connection refused

这时，解决办法也很简单，就是配置一个代理，把下面的内容配置到你的 /etc/hosts 中即可解决

1

199.232.28.133 raw.githubusercontent.com

CentOS 相关命令

防火墙相关：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

#启动防火墙
systemctl start firewalld.service

#关闭防火墙
systemctl stop firewalld.service

#开机启动防火墙
systemctl enable firewalld.service

#禁用开机启动防火墙
systemctl disable firewalld.service

#重启防火墙
firewall-cmd --reload

#显示防火墙开放的端口
firewall-cmd --list-ports

#查询端口是否开放
firewall-cmd --query-port=80/tcp

#开启端口
firewall-cmd --zone=public --add-port=80/tcp --permanent

#停止端口
firewall-cmd --zone=public --remove-port=80/tcp --permanent

查看端口访问情况:

1
2
3
4
5
6
7
8
9
10
11

#列出所有端口情况
netstat -ntlp

#查看某个端口被哪个进程占用
netstat -lnp|grep 443

#查看进程的详细信息
ps 1777

#终止进程
kill -9 1777

apache命令:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

#编辑Apache配置文件
vim /etc/httpd/conf/httpd.conf

#增加转发配置
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so

ProxyPass /wx http://0.0.0.0:8080/wx
ProxyPassReverse /wx http://0.0.0.0:8080/wx

#启动
systemctl start httpd

#停止
systemctl stop httpd

#重启
systemctl restart httpd

#查看状态
status httpd.service

后台运行:

1
2
3
4
5

#在后台执行 root 目录下的 runoob.sh 脚本
nohup /root/runoob.sh &

#查找到 nohup 运行脚本到 PID
ps -aux | grep "runoob.sh"

软链接报错相关

若出现类似下面的报错，可以尝试修复软连接来解决：

1
2

$ /usr/local/bin/python3 --version
no such file or directory: /usr/local/bin/python3

解决方法:

1
2
3
4
5
6

#先移除软链接
cd /usr/local/bin/
rm python3

#建立新的软链接
ln -s /usr/local/opt/python@3.8/bin/python3 /usr/local/bin/python3

测试一下是否可用：

1
2

$ /usr/local/bin/python3 --version
Python 3.8.6

Homebrew更新相关

如果你之前折腾过不少导致你的Homebrew有点问题，那么可以尝试使用如下方案：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 诊断Homebrew的问题:
brew doctor

# 重置brew.git设置:
cd "$(brew --repo)"
git fetch
git reset --hard origin/master

# homebrew-core.git同理:
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git fetch
git reset --hard origin/master

# 应用生效:
brew update

关闭brew执行命令时自动更新：

1
2

# 在 ~/.bash_profile 或者 ~/.zshrc 新增一行
export HOMEBREW_NO_AUTO_UPDATE=true

Crontab定时任务

以定时启动爬虫为例

1
2
3
4
5
6
7

# 查看命令得绝对路径
$which scrapy
/usr/local/bin/scrapy

# cd到爬虫得项目目录下 + scrapy命令得绝对路径  +  启动命令
# 每5分钟执行一次iTorrents这个爬虫程序
*/5 * * * * cd /home/iSpiders && /usr/local/bin/scrapy crawl iTorrents >>/home/log/iTorrents.log 2>&1   # 将正确和错误日志都打印到日志中

命令详解

1
2
3
4
5
6
7
8
9
10
11
12
13
14

#创建定时任务
crontab -e     

#查看定时任务
crontab   -l

#停止定时任务
service crond stop

#重启定时任务
service crond restart

#启动定时任务
service crond start

crontab的命令构成为 时间+动作，其时间有分、时、日、月、周五种，操作符有：
* 取值范围内的所有数字
/ 每过多少个数字
- 从X到Z
, 散列数字

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

#每1分钟执行一次cmd
* * * * * cmd

#每小时的第3和第15分钟执行
3,15 * * * * cmd

#在上午8点到11点的第3和第15分钟执行
3,15 8-11 * * * cmd

#每隔两天的上午8点到11点的第3和第15分钟执行
3,15 8-11 */2  *  * cmd

#每周一上午8点到11点的第3和第15分钟执行
3,15 8-11 * * 1 cmd

#每晚的21:30执行
30 21 * * * cmd

#每月1、10、22日的4 : 45执行
45 4 1,10,22 * * cmd

#每周六、周日的1 : 10执行
10 1 * * 6,0 cmd

#每天18 : 00至23 : 00之间每隔30分钟执行
0,30 18-23 * * * cmd

#每星期六的晚上11 : 00 pm执行
0 23 * * 6 cmd

#每一小时重启smb
* */1 * * * cmd

#晚上11点到早上7点之间，每隔一小时执行
* 23-7/1 * * * cmd

允许任何来源

我们打开一些应用文件时会失败并且提示 “来自身份不明的开发者”，此时开启“设置” → “安全与隐私” 中的 “任何来源” 即可解决问题。但 macOS 10.13 以后的系统默认没有这一选项，此时在 “终端” 中输入以下命令：

1

sudo spctl --master-disable

执行上述步骤之后，“任何来源” 选项就会出现了。

注意：如果在系统偏好设置的 “安全与隐私” 中重新选中允许 “App Store 和 “被认可的开发者”，允许 “任何来源” 的选项会再次消失，可运行上述命令再次开启。

自动开机

苹果从 2016款的MacBook Pro就增加了自动开机功能，每当我们翻开屏幕上盖以后，MacBook就会自动开机，如果不喜欢此功能，在 “终端” 输入以下命令可以设置：

1
2
3
4
5
6
7
8
9
10
11

关闭自动开机
sudo nvram AutoBoot=%00

开启自动开机
sudo nvram AutoBoot=%03

开启开机音效
sudo nvram BootAudio=%01

关闭开机音效
sudo nvram BootAudio=%00

重签名软件

因为Apple苹果公司删除了TNT的证书，所以在2019年7月12日后TNT破解的软件都不能运行了，临时的解决办法，就是自己签名。

准备工作

首先需要安装 Xcode，可以在App Store中下载安装，并且至少运行一次。

安装Command Line Tools 工具，打开终端工具输入如下命令：

1

xcode-select --install

弹出后选择继续安装。

签名

打开终端工具输入并执行如下命令：

1

codesign --force --deep --sign - /Applications/name.app

注意后面的文件路径，你可以打开访达找到应用程序，找到要签名的软件，直接拖入 终端 界面，即可自动生成路径。

启动台出现两个相同快捷方式

进入以下目录

1

~/Library/Application Support/Dock

删除里面的 .db 文件，然后重启电脑即可

Push 到 GitHub 时报错 GH007

报错信息如下：

1

remote: error: GH007: Your push would publish a private email address.

遇到这个问题有两种解决办法：

1. 修改 GitHub 设置选项

找到设置选项：Settings → Emails → Keep my email addresses private

将此项去掉勾选即可

2. 修改本地的 Git 配置信息

1
2
3
4
5
6

# 修改全局邮件地址
git config --global user.email "username@users.noreply.github.com"
git config user.email "username@users.noreply.github.com"

# 重置commit的作者信息
git commit --amend --reset-author

再次提交即可

Push 空的目录到 GitHub

创建一个 .gitkeep 文件于目录内即可

本帖用于记录使用Git过程中遇到的问题，不定时更新中…

前言

shell的类型有很多种，linux下默认的是bash，虽然bash的功能已经很强大，但对于以懒惰为美德的程序员来说，bash的提示功能不够强大，界面也不够炫，并非理想工具。

而zsh的功能极其强大，只是配置过于复杂，起初只有极客才在用。后来，有个穷极无聊的程序员可能是实在看不下去广大猿友一直只能使用单调的bash, 于是他创建了一个名为 Oh My Zsh 的开源项目。

自此，只需要简单的安装配置，小白程序员们都可以用上高档大气上档次，狂拽炫酷吊炸天的 Oh My Zsh

安装与配置

安装

在终端执行以下语句

1

sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

成功界面

1
2
3
4
5
6
7
8
9
10

  ____  / /_     ____ ___  __  __   ____  _____/ /_  
 / __ \/ __ \   / __ `__ \/ / / /  /_  / / ___/ __ \ 
/ /_/ / / / /  / / / / / / /_/ /    / /_(__  ) / / / 
\____/_/ /_/  /_/ /_/ /_/\__, /    /___/____/_/ /_/  
                        /____/                       ....is now installed!
Please look over the ~/.zshrc file to select plugins, themes, and options.

p.s. Follow us at https://twitter.com/ohmyzsh.

p.p.s. Get stickers and t-shirts at http://shop.planetargon.com.

设置默认的shell为zsh

1

chsh -s /bin/zsh

此时重启终端则会切换为zsh

配置

修改配置文件

1

vi ~/.zshrc

找到以下内容 # If you come from bash you might have to change your $PATH. 去掉注释的 # 后

1
2

# If you come from bash you might have to change your $PATH.
export PATH=$HOME/bin:/usr/local/bin:$PATH

找到 # User configuration 这一行，在下面添加

1
2

# User configuration
source ~/.bash_profile

保存退出之后，使用以下命令使 zsh 的配置立即生效

1

source ~/.zshrc

主题

Oh My Zsh 有很多的主题供用户选择：主题列表

修改主题

编辑配置文件

1

vi ~/.zshrc

找到 ZSH_THEME 这一行，修改为主题的名字，例如：

1

ZSH_THEME="ys"

更新配置

1

source ~/.zshrc

插件

下载插件

zsh-syntax-highlighting

输入正确的常用命令会以绿色高亮显示，输入错误则会显示其他的颜色。
使用以下命令安装：

1

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM}/plugins/zsh-syntax-highlighting

zsh-syntax-highlighting

输入命令时，会用浅色字体给出建议的命令，按 → 即可自动补全。
使用以下命令安装：

1

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM}/plugins/zsh-autosuggestions

z.lua

z.lua 是一个快速路径切换工具，它会跟踪你在 shell 下访问过的路径，通过一套称为 Frecent 的机制（源自 FireFox），经过一段简短的学习之后，z.lua 会帮你跳转到所有匹配正则关键字的路径里 Frecent 值最高的那条路径去。
使用以下命令安装：

1

git clone https://github.com/skywind3000/z.lua.git ${ZSH_CUSTOM}/plugins/z.lua

除此之外还需安装 lua 环境，可以用 Homebrew 安装：

1

brew install lua

载入插件

编辑配置文件

1

vi ~/.zshrc

找到 plugin 这一行，将插件加入：

1

plugins=(git zsh-autosuggestions zsh-syntax-highlighting z.lua)

并在文件末尾加入下面语句

1
2
3
4
5
6
7
8

# ZSH 初始化
eval "$(lua $ZSH/custom/plugins/z.lua/z.lua --init zsh enhanced once echo)"
# 严格匹配当前路径的子路径
alias zz='z -c' 
# 使用交互式选择模式
alias zi='z -i'
# 快速回到父目录
alias zb='z -b'

更新配置

1

source ~/.zshrc

尾声

Your terminal never felt this good before…

前言

准备工作

• 网络代理服务器
• 网络代理客户端

为了方便测试，请将网络代理客户端设置为 全局模式
如果这两者你都没有，可以使用：shadowsocks

环境信息

配置时任选其一即可：

配置

如果你没安装过zsh，请按照系统默认终端命令行操作

macOS默认终端命令行配置

1. 修改 bash_profile

1

vi ~/.bash_profile

2. 在文件结尾增加以下配置

1
2
3

# proxy
alias proxy='export all_proxy=socks5://127.0.0.1:1086'
alias unproxy='unset all_proxy'

3. 使配置生效

1

source ~/.bash_profile

zsh命令行配置

1. 修改 zshrc

1

vi ~/.zshrc

2. 在文件结尾增加以下配置

1
2
3

# proxy
alias proxy='export all_proxy=socks5://127.0.0.1:1086'
alias unproxy='unset all_proxy'

3. 使配置生效

1

source ~/.zshrc

配置验证

1. 查看现有IP

1
2
3
4
5

#查看ip
curl myip.ipip.net

#返回结果
当前 IP：117.151.xxx.xxx  来自于：中国 湖北 武汉 电信

2. 开启代理并查看IP

1
2
3
4
5
6
7
8

#开启代理
proxy

#查看ip
curl myip.ipip.net

#返回结果
当前 IP：119.28.xxx.xxxx  来自于：中国 香港   tencent.com

3. 关闭代理并查看IP

1
2
3
4
5
6
7
8

#开启代理
unproxy

#查看ip
curl myip.ipip.net

#返回结果
当前 IP：117.151.xxx.xxx  来自于：中国 湖北 武汉 电信

常见问题

• 问题：command not found: proxy
  说明你未使用source命令使配置生效

• 问题：curl: (7) Failed to connect to 127.0.0.1 port 1080: Connection refused
  请检查协议类型 socks、http是否配置有误，并检查端口是否配置有误

• 问题：curl: (52) Empty reply from server
  请检查你的代理服务器是否正常

• 问题：执行proxy命令后，curl请求超时
  请检查协议类型 socks、http是否配置有误，以及检查你的代理服务器是否正常

提醒：每个新开窗口都需要单独执行命令才可以正常使用

关于脚本

此脚本为 ShadowsocksR 服务端一键安装脚本
请下载与之配套的客户端程序来连接

适用环境

系统支持：CentOS / Debian / Ubuntu
内存要求：≥128M
作者：秋水逸冰

配置说明

服务器端口：自己设定（如不设定，默认为 8989）
密码：自己设定（如不设定，默认为 teddysun.com）
加密方式：自己设定（如不设定，默认为 aes-256-cfb）
协议（Protocol）：自己设定（如不设定，默认为 origin）
混淆（obfs）：自己设定（如不设定，默认为 plain）

部署教程

安装脚本

使用 root 用户登录，执行以下命令

1
2
3
4
5
6
7
8

#获取脚本
wget --no-check-certificate https://raw.githubusercontent.com/teddysun/shadowsocks_install/master/shadowsocksR.sh

#赋予脚本运行权限
chmod +x shadowsocksR.sh

#运行脚本
./shadowsocksR.sh 2>&1 | tee shadowsocksR.log

CentOS 7 系统如出现 -bash: wget: command not found 错误请先执行以下命令安装 wget

1

yum -y install wget

安装完成后，脚本提示如下：

1
2
3
4
5
6
7
8
9

Congratulations, ShadowsocksR server install completed!
Your Server IP        :your_server_ip
Your Server Port      :your_server_port
Your Password         :your_password
Your Protocol         :your_protocol
Your obfs             :your_obfs
Your Encryption Method:your_encryption_method
Welcome to visit:https://shadowsocks.be/9.html
Enjoy it!

此时已后台启动 ShadowsocksR，运行以下命令可以查看 ShadowsocksR 进程是否已经启动

1

/etc/init.d/shadowsocks status

本脚本安装完成后，已将 ShadowsocksR 自动加入开机自启动。

卸载方法

使用 root 用户登录，执行以下命令

1

./shadowsocksR.sh uninstall

使用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

#启动
/etc/init.d/shadowsocks start

#停止
/etc/init.d/shadowsocks stop

#重启
/etc/init.d/shadowsocks restart

#状态
/etc/init.d/shadowsocks status

#配置文件路径
/etc/shadowsocks.json

#日志文件路径
/var/log/shadowsocks.log

#代码安装目录
/usr/local/shadowsocks

多用户配置示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

{
"server":"0.0.0.0",
"server_ipv6": "[::]",
"local_address":"127.0.0.1",
"local_port":1080,
"port_password":{
    "8989":"password1",
    "8990":"password2"，
    "8991":"password3"
},
"timeout":300,
"method":"aes-256-cfb",
"protocol": "origin",
"protocol_param": "",
"obfs": "plain",
"obfs_param": "",
"redirect": "",
"dns_ipv6": false,
"fast_open": false,
"workers": 1
}

SSR协议和混淆插件说明

工作原理

C->S方向

浏览器请求（socks5协议） -> ssr客户端 -> 协议插件（转为指定协议） -> 加密 -> 混淆插件（转为表面上看起来像http/tls） -> ssr服务端 -> 混淆插件（分离出加密数据） -> 解密 -> 协议插件（转为原协议） -> 转发目标服务器

其中，协议插件主要用于增加数据完整性校验，增强安全性，包长度混淆等，协议插件主要用于伪装为其它协议

客户端

客户端的协议插件暂无配置参数，混淆插件有配置

参数混淆插件列表如下：

• plain：不混淆，无参数
• http_simple：简易伪装为http get请求，参数为要伪装的域名，如cloudfront.com。仅在C#版客户端上支持用逗号分隔多个域名如a.com,b.net,c.org，连接时会随机使用其中之一。不填写参数时，会使用此节点配置的服务器地址作为参数。
• http_post：与http_simple绝大部分相同，区别是使用POST方式发送数据，符合http规范，欺骗性更好，但只有POST请求这种行为容易被统计分析出异常。参数配置与http_simple一样
• tls1.2_ticket_auth：伪装为tls请求。参数配置与http_simple一样

其它插件不推荐使用，在这里忽略

客户端的协议插件，仅建议使用 origin / verify_sha1 / auth_sha1_v2 / auth_sha1_v4 / auth_aes128_md5 / auth_aes128_sha1，解释如下：

• origin：原版协议，为了兼容
• verify_sha1：原版OTA协议，为了兼容
• auth_sha1_v2：中等安全性，无时间校对的要求，适合路由器或树莓派，混淆强度大
• auth_sha1_v4：较高安全性，有宽松的时间校对要求，混淆强度大
• auth_aes128_md5 或 auth_aes128_sha1：最高安全性，有宽松的时间校对要求，计算量相对高一些，混淆强度较大

如不考虑兼容，可无视前两个

服务端

大部分插件都可以通过添加 compatible 后缀以表示兼容原版，例如默认的http_simple_compatible 或 auth_sha1_v4_compatible ；

服务端的协议插件，仅 auth_* 系列有协议参数，其值为整数。表示允许的同时在线客户端数量，建议最小值为 2 ，默认值 64；

服务端的混淆插件，http_simple 或 http_post 有混淆参数，用逗号分开若干个host，表示客户端仅能使用以上任一个host连接，而留空表示客户端可以使用任意host。tls1.2_ticket_auth 有混淆参数，其值为整数，表示与客户端之间允许的UTC时间差，单位为秒，为 0 或不填写（默认）表示无视时间差。

总结

如不考虑原版的情况下，推荐使用的协议，只有 auth_sha1_v4 和 auth_aes128_md5 和 auth_aes128_sha1 ，推荐使用的混淆只有 plain / http_simple / http_post / tls1.2_ticket_auth 不要奇怪为什么推荐 plain，因为混淆不总是有效果，要看各地区的策略的，有时候不混淆让其看起来像随机数据更好。

Gem

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

#查看当前源
gem sources -l 

#移除源
sudo gem sources --remove https://rubygems.org/ 

#添加源
sudo gem sources -a https://gems.ruby-china.com/

#升级Gem
sudo gem update --system

#卸载
sudo gem uninstall cocoapods

#查看本地安装过的CocoaPods相关
gem list --local | grep cocoapods

CocoaPods

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

#安装CocoaPods
sudo gem install cocoapods

#设置仓库
pod setup

#查看当前版本号
pod --version

#创建Podfile
touch Podfile

#搜索第三方库:<#name#>
pod search <#name#>

#导入第三方库,默认会执行pod repo update指令
pod install

#导入第三方库
pod install --no-repo-update

#更新第三方库,默认会执行pod repo update指令
pod update

#更新第三方库
pod update --no-repo-update

#清除缓存文件 search_index.json
rm ~/Library/Caches/CocoaPods/search_index.json

#删除本地的Podspec仓库,<#name#>为仓库名字
pod repo remove <#name#>

#本地添加Podspec仓库,<#name#>为仓库名字,<#source#>为仓库地址
pod repo add <#name#> <#source#>

#更新本地Podspec仓库,<#name#>为仓库名字
pod repo update <#name#>

#创建一个Pod制作工程,<#project#>为工程名字
pod lib create <#project#>

#验证制作的Podspec是否通过
pod lib lint

#验证制作的Podspec是否通过,编译库文件,允许警告
pod lib lint --allow-warnings --use-libraries

#发布制作的Podspec
pod repo push <#name#> <#spec#>

#发布制作的Podspec,编译库文件,允许警告
pod repo push <#name#> <#spec#> --allow-warnings --use-libraries

#本地Pod库缓存列表
pod cache list

#删除本地名为<#name#>库的缓存
pod cache clean <#name#>

参数 --verbose 和--silent

这两个参数是用来控制 pod 命令的，在看到输出的情况下可以选择 --silent 。而对于在执行这命令的情况下如果出错，则可能添加 --verbose 的参数能看到具体的出错信息。--verbose则是用来输出这两条命令执行过程中所包含的所有信息，对于大多数的 Cocoapods 的命令行来说都带有着两个参数。

Podfile

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

#适配iOS 8.0及以上系统
platform :ios, '8.0'

#编译成动态库
use_frameworks!

#屏蔽警告
inhibit_all_warnings! 

#官方开源库地址
source 'https://github.com/CocoaPods/Specs.git'

#私有库地址
source 'https://xxxxx.com/xxxx/xxxx.git'

#适配名字为App的工程
target 'App' do

  #导入AFNetworking 3.0及以上的版本
  pod 'AFNetworking', '~> 3.0'
  
  #适配名字为AppTests的子工程
  target 'AppTests' do
    pod 'FBSnapshotTestCase'
    
  end
  
end

注： use_frameworks! 指明编译成动态库，而不是静态库。它会把所有项目的编译动态库，这一点不太好，但是在使用 Swift 库的过程中必须加上这句。

关于Podfile文件编辑时，第三方库版本号的各种写法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

#不显式指定依赖库版本，表示每次都获取最新版本
pod 'AFNetworking' 

#只使用2.0版本
pod 'AFNetworking', '2.0' 

#使用高于2.0的版本
pod 'AFNetworking', '>2.0' 

#使用大于或等于2.0的版本
pod 'AFNetworking', '>=2.0'

#使用小于2.0的版本
pod 'AFNetworking', '<2.0' 

#使用小于或等于2.0的版本
pod 'AFNetworking', '<=2.0'

#使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
pod 'AFNetworking', '~>0.1.2' 

#使用大于等于0.1但小于1.0的版本
pod 'AFNetworking', '~>0.1' 

#高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本
pod 'AFNetworking', '~>0' 

#使用yanff的AFNetworking版本
pod 'AFNetworking', :git => 'https://github.com/yanff/AFNetworking.git'

#使用2.x分支的版本
pod 'AFNetworking', :branch => '2.x'

更多

• CocoaPods不完全食用指南 — 入门篇

• CocoaPods不完全食用指南 — 制作篇

• CocoaPods不完全食用指南 — 私有篇

前言

随着公司项目变多，很多公共组件需要进行模块化管理，但是公司的代码又不能放在 Github 上，从而诞生了 私有库 这种只面向部分人的第三方开源库，本章将详细讲解基于 CocoaPods 对于模块化和私有库的管理。

概要

私有库 的制作大致分为以下几个步骤:

1. 创建并设置一个私有的 Spec Repo
2. 创建 Pod 的所需要的项目工程文件，并且有可访问的项目版本控制地址
3. 创建 Pod 所对应的 podspec 文件
4. 本地测试配置好 podspec 文件是否可用
5. 向私有的 Spec Repo 提交 podspec 文件
6. 在项目中的 Podfile 中增加制作好的 Pod 并使用
7. 更新维护 podspec
8. 如果了解 公有库 的制作步骤，可以发现 私有库 的制作步骤多了一个创建私有的 Spec Repo 的过程，而且提交的过程也变成向私有 Spec Repo 提交了。

在制作私有库之前，推荐不了解的 公有库制作步骤 的同学先去了解一下

创建私有Spec Repo

Spec Repo 是一个装着所有 Pods 的索引容器，所有公开的 Pods 的索引都在这个里面，它是一个托管在 Github 的远程仓库。在本地使用 CocoaPods 后它会被 clone到本地的 ~/.cocoapods/repos 目录下，进入该目录可以看到如下结构：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

.
├── master
│   ├── CocoaPods-version.yml
│   ├── README.md
│   └── Specs
│       ├── 0
│       ├── 1
│       ├── 2
│       ├── 3
│       ├── 4
│       ├── 5
│       ├── 6
│       ├── 7
│       ├── 8
│       ├── 9
│       ├── a
│       ├── b
│       ├── c
│       ├── d
│       ├── e
│       └── f

Specs 文件夹中就是所有向 CocoaPods 注册过的第三方库的索引。因此，我们建立私有库的第一步就是建立一个私有的 Spec Repo，在公司的 Git 上创建一个私有的仓库 Spec Repo，然后在本地增加 CocoaPods 的私有 Spec Repo 仓库

1
2
3

# private 是本地私有仓库的名字
# 地址是私有仓库的可访问地址,最好是SSH地址
pod repo add private root@git.canplay.com.cn:yanff/SpecRepo.git

此时到 ~/.cocoapods/repos 目录，可以看到多了个 private 的文件夹：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

.
├── master
│   ├── CocoaPods-version.yml
│   ├── README.md
│   └── Specs
│       ├── 0
│       ├── 1
│       ├── 2
│       ├── 3
│       ├── 4
│       ├── 5
│       ├── 6
│       ├── 7
│       ├── 8
│       ├── 9
│       ├── a
│       ├── b
│       ├── c
│       ├── d
│       ├── e
│       └── f
└── private
    ├── LICENSE
    └── README.md

此时创建私有 Spec Repo 的步骤就完成了

创建私有Pod工程文件

创建与测试的过程在这里不再详解，需要注意的是:
Pod 项目工程文件所添加的远程仓库应该也在公司的 Git 上，而且拥有地址的访问权限，Podsepc 文件中的地址最好是仓库的 SSH 地址。

Spec Repo提交podspec

与创建 公有库 不同的是，此时提交应该向私有 Spec Repo 提交

1
2

# private 是本地私有仓库的名字
pod repo push private PodDemo.podspec

此时在之前建立的远程 Spec Repo 仓库里能看到我们提交的 podspec 文件了

最后更新一下本地的私有 Spec Repo

1
2

# private 是本地私有仓库的名字
pod repo update private

然后输入搜索命令

1

pod search PodDemo

就可以搜索到刚刚提交的库了

1
2
3
4
5
6

-> PodDemo (1.0.0)
   a brief introduction
   pod 'PodDemo', '~> 1.0.0'
   - Homepage: https://root@git.canplay.com.cn:yanff/PodDemo
   - Source:   https://root@git.canplay.com.cn:yanff/PodDemo.git
   - Versions: 1.0.0 [private repo]

此时，我们的私有库就制作完毕了。

在Podfile中加入私有Spec Repo地址

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

platform :ios, '8.0' #当前工程最低支持iOS 8.0

source 'https://github.com/CocoaPods/Specs.git'  # 官方库
source 'root@git.canplay.com.cn:yanff/SpecRepo.git'  # 私有库

target 'NAME' do    #NAME是工程的名字

pod 'AFNetworking', '~> 3.1.0' #导入AFNetworking 3.1.0的版本

pod 'PodDemo', '~> 1.0.0'

end
~
~
~
~
~
~
-- INSERT --

然后执行命令就可以使用私有库了

1

pod install

注意

如果有其他合作人员共同使用这个私有库 的话，需要给予对应远程 私有库 仓库和 Spec Repo 仓库的权限，最好使用 SSH 认证连接 ，然后再执行上面的命令添加这个 Spec Repo 到本地即可。

更多

• CocoaPods不完全食用指南 — 入门篇

• CocoaPods不完全食用指南 — 制作篇

• CocoaPods不完全食用指南 — 指令集

前言

对于公开给所有人的开源库，我们称之为公有库；而针对部分人的开源库，比如公司内部的开源，我们称之为私有库。本章所讲解的是如何使公有库支持 Cocoapods，能在Cocoapods 上搜索并且使用。

概要

公有库 的制作大致分为以下几个步骤:

1. 创建 Pod 的所需要的项目工程文件，并且有可访问的项目版本控制地址
2. 创建 Pod 所对应的 podspec 文件
3. 本地测试配置好 podspec 文件是否可用
4. 向 Spec Repo 提交 podspec 文件
5. 在项目中的 Podfile 中增加制作好的 Pod 并使用
6. 更新维护 podspec

创建Pod项目工程文件

Cocoapods 为我们提供了快熟创建Pod项目工程的工具，先进入桌面cd Desktop/

1

pod lib create PodDemo

然后会出现

1
2
3
4
5
6

Cloning `https://github.com/CocoaPods/pod-template.git` into `PodDemo`.
Configuring PodDemo template.

------------------------------

To get you started we need to ask a few questions, this should only take a minute.

接下来会出现几个问题：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

#选择语言
What language do you want to use?? [ Swift / ObjC ]
 > ObjC
 
#是否需要一个例子工程
Would you like to include a demo application with your library? [ Yes / No ]
 > Yes 

#选择一个测试框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None

#是否基于View测试
Would you like to do view based testing? [ Yes / No ]
 > Yes

#类的前缀
What is your class prefix?
 > YAN

输入完后，就开始建立工程，最后出现

1

Pod installation complete! There are 2 dependencies from the Podfile and 2 total pods installed.

查看新建的工程目录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

.
├── Example
│   ├── PodDemo
│   ├── PodDemo.xcodeproj
│   ├── PodDemo.xcworkspace
│   ├── Podfile              # PodDemo的依赖描述文件
│   ├── Podfile.lock
│   ├── Pods                 # PodDemo的依赖文件
│   └── Tests
├── LICENSE                  #开源协议 默认MIT
├── PodDemo                  #组件的目录
│   ├── Assets               #资源文件
│   └── Classes              #类文件
├── PodDemo.podspec          #podspec文件
├── README.md                #Markdown格式的README
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj

10 directories, 5 files

接下来就是将要开源的文件放入 PodDemo/Classes中，PodDemo/Assets中放入资源文件，然后进入Example文件夹执行

1

pod update

此时再打开工程就能看到刚刚添加的文件已经在Pods工程下 Development Pods/PodDemo中了，然后就可以编辑工程Demo了。

注：这里需要注意的是每次向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。

推送到远程仓库

首先到Github创建一个Public仓库

通过 Cocoapods 创建出来的目录本身就在本地的 Git 管理下，我们需要做的就是给它添加远端仓库，先到 PodDemo 目录下，先添加上面创建仓库的 SSH 地址，然后把代码推送到远程

1
2
3
4
5
6
7
8

#提交到暂存区
git add .
#提交信息
git commit -s -m "Initial Commit of PodDemo"
#添加远程仓库
git remote add origin git@github.com:yanff/PodDemo.git
#推到远端仓库
git push origin master

推送完后我们可以看到Github上的远程仓库已经有了代码

因为 podspec 文件中获取Git版本控制的项目还需要tag号，所以我们要打上一个tag

1
2

git tag -m "first release" 1.0.0
git push --tags     #推送tag到远端仓库

编辑Podsepc文件

在所有支持 Cocoapods 导入的库的开源目录下，都有一个 .Podsepc 的文件。无论是做公有库还是私有库，都必须配置这个文件。Podsepc 文件中记录了库的一些基本信息，包括版本号、获取的地址等等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

Pod::Spec.new do |s| 

  #库的名字
  s.name         = "PodDemo"
  
  #库的版本号
  s.version      = "1.0.0"
  
  #库的简介
  s.summary      = "a brief introduction"
  
  #库的主页
  s.homepage     = "https://github.com/yanff/PodDemo"
  
  #许可证信息
  s.license      = { :type => "MIT", :file => 'LICENSE.md' }
  
  #作者的信息
  s.author       = { "yanff" => "yanff.us@gmail.com" }
  
  #库支持的iOS最低版本
  s.platform     = :ios, "8.0" 
  
  #库文件的源码地址
  s.source       = { :git => "https://github.com/yanff/PodDemo.git", :tag => s.version} 
  
  #所需要支持的框架
  s.frameworks   = 'UIKit' 
  
  #配置库所需的文件,**表示全匹配,*.{h,m}表示匹配所有的.h和.m文件
  s.source_files = "PodDemo/Classes/*.{h,m}"
  
  #库所需的资源文件
  s.resource     = "PodDemo/Assets/**" 
  
  #支持ARC还是MRC
  s.requires_arc = true 
  
  #依赖第三方库，例如:AFNetworking,3.1.0版本
  s.dependency 'AFNetworking', '~>3.1.0'  
  
  #注：非必须，针对库进行模块化才需做子目录的处理
  s.subspec 'SubPodDemo' do |ss|
    ss.source_files = 'PodDemo/SubPodDemo/**/*.{h,m}'
  end
  
end

编辑完 podspec文件后，需要验证一下这个文件是否可用，如果有任何 WARNING 或者 ERROR 都是不可以的，它就不能被添加到 Spec Repo 中，不过 Xcode 的 WARNINGO 是可以存在的，验证需要执行命令

1

pod lib lint

如果看到

1
2
3

 -> PodDemo (1.0.0)

PodDemo passed validation.

说明验证通过了，不过只是这个 podspec 文件是合格的，不一定说明这个 Pod 是可用的，我们需要本地验证一下

本地测试podspec文件

本地创建一个新的项目，在这个项目的 Podfile 文件中直接指定刚才创建编辑好的 podspec 文件，测试能否使用。在 Podfile 文件中编辑

1
2
3
4

platform :ios, '8.0'

# 指定podspec文件
pod 'PodDemo', :podspec => '/Users/Yan/Desktop/PodDemo/PodDemo.podspec'

然后执行 pod install命令安装依赖，打开项目工程，可以看到库文件都被加载到 Pods子项目中了。在项目中编写代码，测试库文件无误后就可以提交 podspec 到 Spec Repo中了

向Spec Repo提交podspec

注册trunk，查看是否注册过

1

pod trunk me

如果没有注册

1

pod trunk register yanff.us@gmail.com "YAN"

注册完后，提交到 Spec Repo

1

pod trunk push PodDemo.podspec

最后更新一下本地的 Spec Repo

1

pod repo update

然后输入搜索命令

1

pod search PodDemo

就可以搜索到刚刚提交的库了

1
2
3
4
5
6

-> PodDemo (1.0.0)
   a brief introduction
   pod 'PodDemo', '~> 1.0.0'
   - Homepage: https://github.com/yanff/PodDemo
   - Source:   https://github.com/yanff/PodDemo.git
   - Versions: 1.0.0 [master repo]

自此，我们也成为了开源主义的接班人，公有库的制作已经完毕了，其他人可以通过CocoaPods使用我们制作的库了

关于更新和维护

如果想要更新和维护版本，只需要在PodDemo/Classes中进行源码的修改，然后在Podsepc文件中修改文件的路径以及版本号，需要注意的是，版本号一定要对应相应仓库的tag ，而且每次进行修改的时候，版本号不能低于原来的版本号，然后再向 Spec Repo 提交新的podspec

更多

• CocoaPods不完全食用指南 — 入门篇

• CocoaPods不完全食用指南 — 私有篇

• CocoaPods不完全食用指南 — 指令集

简介

1. 什么是 CocoaPods

每种语言发展到一个阶段，就会出现相应的依赖管理工具，例如 Java 的 Maven 、Node.js 的 NPM 。而CocoaPods， 就是 OS X 和 iOS 下 的一个第三方库管理工具。它的源码在 Github 上管理，项目开始于 2011 年 8 月 12 日，经过多年发展，现在已经成为 OS X 和 iOS 开发的依赖管理标准工具，它的出现使得我们可以节省设置和更新第三方开源库的时间。

2. CocoaPods 的好处

使用 CocoaPods 可以很方便地查找新的第三方库，在引入第三方库时可以自动为我们配置好依赖的环境，包括配置编译阶段、连接器选项，甚至是 ARC 环境下的 -fno-objc-arc 配置等。这些类库是比较“标准的”，从而可以便捷的管理第三方库。

安装

CocoaPods 依赖于 Ruby 环境，目前 OS X *系统默认已经可以运行 *Ruby。Gem 是一个管理 Ruby 库和程序的标准包，我们可以通过 Gem 安装 CocoaPods 。

1. 更换Ruby源

因为 Ruby 的软件源 rubygems.org 使用亚马逊的云服务，国内访问受限，需要更新一下ruby的源

注意：在终端输入命令时，取$后面部分输入

查看当前的 Ruby 源

1

gem sources -l

移除当前的 Ruby 源

1

sudo gem sources --remove https://rubygems.org/

设置当前 Ruby 的源为国内的

1

sudo gem sources -a https://gems.ruby-china.com/

再次查看当前的 Ruby 源

1

gem sources -l

如果 Terminal 输出：

1
2
3

*** CURRENT SOURCES ***

https://gems.ruby-china.com/

则 Ruby 源已经设置成功

2. 升级Gem

如果 Gem 的版本过低也可能导致安装失败，先升级 Gem

1

sudo gem update --system

升级成功后会提示: Latest version currently installed. Aborting.

3. 安装CocoaPods

执行安装 CocoaPods 命令

1

sudo gem install cocoapods

如果报以下错误：

1
2

ERROR:  While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj

说明没有权限，需要输入

1

sudo gem install -n /usr/local/bin cocoapods

安装成功后

1

pod setup

然后会出现 Setting up CocoaPods master repo，此时需要等待的时间较久，这一步是 Cocoapods 在将它的信息下载到 ~/.cocoapods 目录下。
你可以Command + N新建一个终端窗口，执行命令

1
2

cd ~/.cocoapods/
du -sh *

查看下载进度，安装成功后,你会看到 Setup completed

注意：CocoaPods 1.8.0以后不再需要执行 pod setup ，而是会在执行 pod search xxxx 时自动创建索引。

使用

1. 新建 Podfile文件

使用时需要在你的项目根目录下新建一个名为 Podfile 的文件，在工程目录

1

touch Podfile

2. 查找第三方库

以 AFNetworking 为例

1

pod search AFNetworking

如果出现

1

[!] Unable to find a pod with name, author, summary, or description matching `AFNetworking`

这是因为之前pod search的时候生成了缓存文件 search_index.json ，执行

1

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

来删除该文件，然后再次搜索
若搜索后会出现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

-> AFNetworking (3.1.0)
   A delightful iOS and OS X networking framework.
   pod 'AFNetworking', '~> 3.1.0'
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3,
   3.0.0-beta.2, 3.0.0-beta.1, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 2.5.2,
   2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0,
   2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4,
   1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2,
   1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
   - Subspecs:
     - AFNetworking/Serialization (3.1.0)
     - AFNetworking/Security (3.1.0)
     - AFNetworking/Reachability (3.1.0)
     - AFNetworking/NSURLSession (3.1.0)
     - AFNetworking/UIKit (3.1.0)

我们需要用到上面的 pod 'AFNetworking', '~> 3.1.0'

3. 编辑Podfile

使用vim编辑 Podfile 文件

1

vim Podfile

会出现

1
2
3
4
5
6
7
8
9
10
11
12
13
14

~
~
~
~
~
~
~
~
~
~
~
~
~
"podfile" 0L, 0C

按下键盘上的英文 I 键，会变成

1
2
3
4
5
6
7
8
9
10
11
12
13
14

~
~
~
~
~
~
~
~
~
~
~
~
~
-- INSERT --

然后就可以编辑了，输入一下文字

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

platform :ios, '8.0' #当前工程最低支持iOS 8.0

inhibit_all_warnings! #屏蔽所有的警告

target 'NAME' do    #NAME是工程的名字

pod 'AFNetworking', '~> 3.1.0' #导入AFNetworking 3.1.0的版本

end
~
~
~
~
~
~
-- INSERT --

接下来保存文件，按下键盘的 esc 键，然后按下输入 :wq，按下 enter键就保存退出了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

platform :ios, '8.0' #当前工程最低支持iOS 8.0

inhibit_all_warnings! #屏蔽所有的警告

target 'Project' do    # Project是工程的名字

pod 'AFNetworking', '~> 3.1.0' #导入AFNetworking 3.1.0的版本

end
~
~
~
~
~
~
:wq

4. 导入第三方库

执行命令

1

pod install

出现

1
2
3

[!] Please close any current Xcode sessions and use `Project.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

即表示执行成功，此时工程目录会多出 Project.xcworkspace、Podfile.lock 文件和 Pods文件夹，上面提醒我们从现在开始，打开 Project.xcworkspace 来开发，进入工程后，引入头文件不再是

1

#import "AFNetworking.h"

而是

1

#import <AFNetworking.h>

原理和说明

• ** 第三方库会被编译成.a静态库供我们真正的工程使用：**
  CocoaPods 会将所有的第三方库以 target 的方式组成一个名为 Pods 的工程，该工程就放在刚才新生成的 Pods 目录下。整个第三方库工程会生成一个名称为 libPods.a 的静态库提供给我们自己的工程使用。
  对于资源文件，CocoaPods 提供了一个名为 Pods-resources.sh 的 bash 脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。

• ** 我们的工程和第三方库所在的工程会由一个新生成的 workspace 管理：**
  为了方便我们直观的管理工程和第三方库，工程和Pods工程会被以 workspace 的形式组织和管理。

• ** 原来的工程设置已经被更改了，这时候我们直接打开原来的工程文件去编译就会报错，只能使用新生成的 workspace 来进行项目管理。**

• ** CocoaPods 通过一个名为 Pods.xcconfig 的文件来在编译时设置所有的依赖和参数**

更多

• CocoaPods不完全食用指南 — 制作篇

• CocoaPods不完全食用指南 — 私有篇

• CocoaPods不完全食用指南 — 指令集

说明

Apple 开发者账号，除给大学使用的教育账号外，共有个人账号、公司账号、企业账号三种：

• 个人账号：个人申请用于开发 Apple App 所使用的账号，仅限于个人使用，可以在 App Store 发布应用，申请比较容易，￥688.00/年 ($99.00/year)
• 公司账号：以公司名义申请的开发者账号，用于公司内部的开发者共用，可以在 App Store 发布应用，申请流程相对麻烦，￥688.00/年 ($99.00/year)
• 企业账号：一般是公司规模在 500 人以上的企业，用于内部测试、分发应用的账号，不能在 App Store 发布应用，申请流程相对麻烦，￥1988/年 ($299.00/year)

准备工作

• 已经注册好的Apple ID
• visa/万事达信用卡(目前visa单币卡不能支付)

Apple 开发者公司账号申请步骤：

1. 打开 Apple 开发者账号申请链接地址：

点击Enroll(上图红框中按钮)，进入申请页面：

2. 上面的页面介绍了开发者账号的种类，以及申请每个种类账号所需做的准备。点击Start Your Enrollment，进入下一页面。

3. 如果您此时没有登录，会跳转到登录页面先登录您的 Apple ID，之后进入下面的页面：

点击红框内的选项框，可看到如下选项：

选择红框内的Company / Organization，您将看到如下提示：

4. 这些提示描述了加入公司开发者计划所需要具备的条件，特别注意的是，您的公司必须拥有一个邓白氏码(D-U-N-S? Number)。如果您的公司拥有一个，在后面的步骤中，直接填写即可。如您不清楚，可以点击上图红框中的Check now >，浏览器会为您新建一个窗口／标签，跳转到如下页面：

请按照下面的提示填写相关信息：

1. 点击，选择 China
2. 填写公司名称，使用罗马字符，英语，如：Apple Inc.
3. 填写公司所在街道，使用罗马字符，英语，要与营业执照内容一致
4. 填写公司所在城市，使用罗马字符，英语，要与营业执照内容一致
5. 点击，选择公司所在省份
6. 填写邮政编码
7. 点击，选择 86
8. 填写联系电话，手机、座机均可，座机要有区号
9. 填写名字，使用罗马字符
10. 填写姓氏，使用罗马字符
11. 点击，选择 86
12. 填写工作电话，手机、座机均可，座机要有区号
13. 如果有分机号，填写在这里
14. 填写工作 Email 地址，如果您的公司已经拥有邓白氏码，将发送的这个邮箱里
15. 输入上图的验证码
16. 如果 15 中的验证码看不清，可点击这里更换
17. 所有信息填写完成后，这个按钮将变为蓝底白字，点击进入下一页面

5. 完成上面的步骤后，如果您的公司已经拥有邓白氏码，将在一步确认之后，发送到您填写的工作邮箱中；如果没有，可以将这个信息提交到邓白氏公司，经审核后会得到邓白氏码。

• 大概2、3天时间，上海邓白氏分公司会给您打电话，核实您提供的公司信息，他们的工作人员会告知您已经接受了您的申请，请耐心等待14天左右，会把邓白氏码发到您预留的邮箱里。

6. 回到这个页面：

点击Continue，进入下一页，填写相关信息。

7. 由于信息较多，将页面分别截图，并提示填写。

8. 以上信息填写完成后，点击红框内的Continue,进入下一页面

这个页面为最后的信息确认页面，如信息无误，按照图中提示操作，并点击红框内的Submit提交

9. 完成以后，等待苹果公司的确认电话，电话中会核实相关信息，确认完成后，即可填写信用卡信息，缴费，完成申请。

10. 申请期间有任何疑问，可以拨打苹果开发者中心的电话 400-670-1855 咨询。

注：所有过程中，只有在接到苹果公司电话后缴纳开发者计划的首年年费 ￥688.00 ，其他步骤均不收费。