<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>PPPan 的博客</title><description>关于技术、实践，以及做东西时的思考。</description><link>https://www.shengpan.net/</link><language>zh-CN</language><item><title>iOS 本地化省力小技巧</title><link>https://www.shengpan.net/blog/localizad/</link><guid isPermaLink="true">https://www.shengpan.net/blog/localizad/</guid><description>我们造不出巴别塔，却可以通过本地化让不同语言环境的人舒坦地用上我们的 App。</description><pubDate>Thu, 22 Aug 2019 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2019/localizaed-header.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;我们造不出巴别塔，却可以通过本地化让不同语言环境的人舒坦地用上我们的 App。&lt;/p&gt;
&lt;p&gt;但提起本地化，开发者们最直观的感受一定是一堆细碎繁琐的本地化文件字符串文件，以及永远也想不起来的&lt;code&gt;Key&lt;/code&gt;。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// Chinese Simplified
&quot;zelda.btn.confirm&quot; = &quot;确定&quot;;
&quot;zelda.btn.cancel&quot; = &quot;取消&quot;;
&quot;zelda.dish.backed.cocoanut&quot; = &quot;烤椰子&quot;;
&quot;zelda.dish.backed.mushroom.skewer&quot; = &quot;精力烤鱼蘑菇串&quot;;

// English
&quot;zelda.btn.confirm&quot; = &quot;Confirm&quot;;
&quot;zelda.btn.cancel&quot; = &quot;Cancel&quot;;
&quot;zelda.dish.backed.cocoanut&quot; = &quot;Baked Palm Fruit&quot;;
&quot;zelda.dish.backed.mushroom.skewer&quot; = &quot;Energizing Fish and Mushroom Skewer&quot;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在开发的时候，代码里充满了类似不直观的代码。降低了我们的可读性。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;titleLabel.text = NSLocalizedString(@&quot;zelda.dish.backed.cocoanut&quot;, nil);&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;另外，如果开发者一不小心漏掉了某个翻译，界面上就会直接显示你定义的 key。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2019/localizaed-not-translate.jpg&quot;/&gt;&lt;/p&gt;
&lt;p&gt;那么我们能不能…&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;减少一些 Strings 文件维护的工作量&lt;/li&gt;
&lt;li&gt;代码可读性更高一些，不用全局搜索就可以知道某个 Label 将会显示什么内容&lt;/li&gt;
&lt;li&gt;忘记翻译了不至于对用户显示“乱码”&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;答案是肯定的。&lt;br/&gt;使用本地语言作为 Key 就可以解决这三个问题。例如「确定」按钮，我们写代码的时候可以这么写：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;titleLabel.text = NSLocalizedString(&quot;确定&quot;, comment: &quot;&quot;);&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;同时，在目标语言（例如英语）资源文件中添加：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;&quot;确定&quot; = &quot;Comfirm&quot;;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这样便一次性解决了上述的所有问题。&lt;/p&gt;
&lt;p&gt;唯一的一点小遗憾是 NSLocalizedString 宏定义的第二个参数在 99% 的情况下都是空字符，在代码上是一个噪音。我们可以通过为 String 添加一个 extension 来解决它。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;extension String {
    var ps_localized: String {
        get {
            return NSLocalizedString(self, comment: &quot;&quot;)
        }
    }
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2019/localizaed-header.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;愉快地使用新的本地化方式 Coding 吧！&lt;/p&gt;</content:encoded></item><item><title>全站 HTTPS 边做边记</title><link>https://www.shengpan.net/blog/https/</link><guid isPermaLink="true">https://www.shengpan.net/blog/https/</guid><description>没错，这是一篇可以 Step by Step 跟着做的操作指南。</description><pubDate>Fri, 07 Oct 2016 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;没错，这是一篇可以 Step by Step 跟着做的操作指南。&lt;/p&gt;
&lt;p&gt;keyword: &lt;strong&gt;Let’s Encrypt&lt;/strong&gt;, &lt;strong&gt;Ubuntu 14.04&lt;/strong&gt;, &lt;strong&gt;Nginx&lt;/strong&gt;&lt;/p&gt;
&lt;h2 id=&quot;前言&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#前言&quot; title=&quot;前言&quot;&gt;&lt;/a&gt;前言&lt;/h2&gt;&lt;p&gt;关于 HTTPS 可以先看看鹅厂的&lt;a href=&quot;http://mp.weixin.qq.com/s?__biz=MzA3NTYzODYzMg==&amp;amp;mid=402615812&amp;amp;idx=1&amp;amp;sn=b6dae639119bb66e7025321254b8d973&amp;amp;scene=1&amp;amp;srcid=122439MA3l7gRwfjgNOB76pA#rd&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这篇文章&lt;/a&gt;涨涨姿势。&lt;/p&gt;
&lt;p&gt;我们知道 HTTPS 需要一个 CA 来解决信息抵赖和中间人攻击的隐患。&lt;strong&gt;Let’s Encrypt&lt;/strong&gt; 就是一个 CA。它的优势在于免费、被绝大多数浏览器认可、高度自动化。这么好的一个 CA 摆在这里，还多说什么呢，开搞。&lt;/p&gt;
&lt;h2 id=&quot;环境&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#环境&quot; title=&quot;环境&quot;&gt;&lt;/a&gt;环境&lt;/h2&gt;&lt;ul&gt;
&lt;li&gt;操作系统: Ubuntu 14.04&lt;/li&gt;
&lt;li&gt;代理服务器: Nginx&lt;/li&gt;
&lt;li&gt;权限: 拥有 Shell 权限&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;申请证书&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#申请证书&quot; title=&quot;申请证书&quot;&gt;&lt;/a&gt;申请证书&lt;/h2&gt;&lt;p&gt;我们采用官方推荐的自动化工具 &lt;a href=&quot;https://certbot.eff.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Certbot&lt;/a&gt;来进行全自动化的申请。&lt;/p&gt;
&lt;p&gt;首先下载 Certbot, 并修改相关权限.&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ wget https://dl.eff.org/certbot-auto
chmod a+x certbot-auto&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;下载完成后，先关闭 Nginx 服务。因为我们将采用独立模式来安装证书。在独立模式下，certbot-auto 需要占用 80 端口，因此我们需要先暂时关闭 Nginx 来释放 80 端口。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;service nginx stop&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;运行 certbot-auto 命令申请证书&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ ./path/to/certbot-auto certonly --standalone -d example.com -d www.example.com&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;-d&lt;/code&gt; 后面的参数是你需要用 HTTPS 访问的域名。这里不支持通配符，所以子域名比较多的同学得费力都填满了。&lt;/p&gt;
&lt;p&gt;运行过程中，会弹出窗口让你填写邮箱。Let’s Encrypt 的证书的有效期是 90 天。在证书过期后，他们会往这个邮箱发送提醒。&lt;/p&gt;
&lt;p&gt;填完邮箱并接收用户协议后，就会进入如下界面。这说明开始申请并下载证书了。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/10/get-cer.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;稍等片刻，如果出现以下提示，则表示证书申请成功了。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at
   /etc/letsencrypt/live/shengpan.net/fullchain.pem. Your cert will
   expire on 2017-01-05. To obtain a new or tweaked version of this
   certificate in the future, simply run certbot-auto again. To
   non-interactively renew *all* of your certificates, run
   &quot;certbot-auto renew&quot;
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let&apos;s Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;你可以在上述信息中找到证书存放的位置：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/etc/letsencrypt/live/shengpan.net/fullchain.pem&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这在后面的 Nginx 配置中会用到。&lt;/p&gt;
&lt;h2 id=&quot;配置-Nginx&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#配置-Nginx&quot; title=&quot;配置 Nginx&quot;&gt;&lt;/a&gt;配置 Nginx&lt;/h2&gt;&lt;p&gt;找到 Nginx 的配置文件，添加 ssl 配置。以我的 Ghost 博客为例:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;server {  
	listen 443 ssl;
    server_name shengpan.net; 

    ssl_certificate /etc/letsencrypt/live/shengpan.net/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/shengpan.net/privkey.pem;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;
    ssl_ciphers AES256+EECDH:AES256+EDH:!aNULL;

    location / {
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   Host      $http_host;
        proxy_pass         http://127.0.0.1:2368;
   }
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;将 &lt;code&gt;server_name&lt;/code&gt; 改为你的域名，&lt;code&gt;ssl_certificate&lt;/code&gt; 和 &lt;code&gt;ssl_certificate_key&lt;/code&gt; 分别改为你的公私钥路径。&lt;/p&gt;
&lt;h4 id=&quot;兼容-HTTP&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#兼容-HTTP&quot; title=&quot;兼容 HTTP&quot;&gt;&lt;/a&gt;兼容 HTTP&lt;/h4&gt;&lt;p&gt;有可能你的网站在启用 HTTPS 之前已经在某些地方留下过 HTTP 的链接了，而你又不希望这些链接失效，就需要做一些兼容。&lt;/p&gt;
&lt;p&gt;如果你希望全站都使用 HTTPS 访问，只需要把 HTTP 请求重定向到 HTTPS 上即可。在 Nginx 配置文件中添加如下配置：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;server {
    listen 80;
    server_name shengpan.net; 
    return 301 https://$server_name$request_uri;
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果你希望用户可以同时使用 HTTPS 和 HTTP 访问，只需要在配置文件中简单地添加一行:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;listen 443 ssl;
listen 80; # 添加这一行即可
server_name shengpan.net;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;最后我们重启一下 Nginx 服务&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;service nginx start&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在浏览器中输入你的域名看看吧！&lt;/p&gt;
&lt;h2 id=&quot;自动续期&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#自动续期&quot; title=&quot;自动续期&quot;&gt;&lt;/a&gt;自动续期&lt;/h2&gt;&lt;p&gt;Let’s Encrypt 颁发的证书只有 90 天的有效期，过了有效期需要续期。幸运的是 Cerbot 已经帮我们打理好了这一切，只需要一句命令行就可以为你的证书续期。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;To non-interactively renew &lt;em&gt;all&lt;/em&gt; of your certificates, run “certbot-auto renew”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;当然，这句命令行还可以交给计划任务去做，以自动续期。Linux 下我们使用 Cron 实现这一功能。&lt;/p&gt;
&lt;h4 id=&quot;启动-cron-服务&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#启动-cron-服务&quot; title=&quot;启动 cron 服务&quot;&gt;&lt;/a&gt;启动 cron 服务&lt;/h4&gt;&lt;p&gt;通常 ubuntu 下自带 cron，如果没有也可以通过以下命令进行安装：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ apt-get install cron&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;若已经安装，输入以下命令判断 cron 服务是否启动：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ pgrep cron&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果有 pid （一串数字）输出则说明 cron 服务已经启动，没有任何输出说明需要手动启动 cron 服务。&lt;br/&gt;启动 cron 服务：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ service cron start&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;编写需要运行的脚本&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#编写需要运行的脚本&quot; title=&quot;编写需要运行的脚本&quot;&gt;&lt;/a&gt;编写需要运行的脚本&lt;/h4&gt;&lt;p&gt;首先新建一个脚本文件，为了方便识别，我们命名为 &lt;code&gt;refetch-https-cer.sh&lt;/code&gt;，并保存到 &lt;code&gt;/etc/cron.weekly/&lt;/code&gt; 路径下。如果没有该路径则最新建。&lt;/p&gt;
&lt;p&gt;在 &lt;code&gt;refetch-https-cer.sh&lt;/code&gt; 中填入如下内容&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;#!/bin/bash
/usr/bin/service nginx stop
/root/certbot-auto renew
/usr/bin/service nginx start&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;#!/bin/bash&lt;/code&gt; 开头说明该文件是一个 shell 脚本。 下面就是需要执行的命令。这里我们只要三步就能完成 https 证书的更新:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;关闭占用80端口的 nginx 服务（因为我们用 &lt;code&gt;standalone&lt;/code&gt; 模式来使用 &lt;code&gt;cerbot-auto&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;用 certbot 来为证书续期&lt;/li&gt;
&lt;li&gt;重启 HTTP 代理服务器，来使新的 https 证书生效。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;需要注意的是，文件里需要写全命令路径，因为 cron 执行的时候，可能没有 PATH 的环境变量。我的 certbot 命令放在 root 文件夹下，因此是 &lt;code&gt;/root/certbot-auto renew&lt;/code&gt;，你需要将其替换为你的 certbot 命令路径。&lt;/p&gt;
&lt;p&gt;最后我们需要修改一下改脚本文件的权限。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ chmod 777 /etc/cron.quarterly/refetch-https-cer.sh&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;编写配置文件&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#编写配置文件&quot; title=&quot;编写配置文件&quot;&gt;&lt;/a&gt;编写配置文件&lt;/h4&gt;&lt;p&gt;cron 是以载入配置文件的方式来运行计划任务的。因此，只需要编写好配置文件并将其提交到 cron 服务中，它就会按照配置定期运行相关任务。&lt;/p&gt;
&lt;p&gt;我们新建一个配置文件，命名为 rootcron , 保存到 &lt;code&gt;/var/spool/cron/&lt;/code&gt;。该路径是所有用户 cron 文件存放的目录。&lt;/p&gt;
&lt;p&gt;编辑 rootcron 文件，添加如下内容:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;# refetch https certificate per week
# minute hour day month week command
0 3 * * 2 /etc/cron.weekly/refetch-https-cer.sh &amp;gt;&amp;gt; /root/for_crontab/error.log&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这个配置文件的意思就是，在每周二的凌晨 3 点，执行我们先前编写的用来自动续期的脚本，并将错误日志输出到 &lt;code&gt;/root/for_crontab/error.log&lt;/code&gt; 文件中。&lt;/p&gt;
&lt;p&gt;你可以自定义log文件的路径，但要保证在编写这个配置文件之前，已经把 log 文件创建好了。这样你可以偶尔上来看看日志文件，确保计划任务正常运行。&lt;/p&gt;
&lt;p&gt;你也可以根据自己证书的过期时间，自定义任务的计划时间。想要知道如何自定义自己的配置文件，请看&lt;a href=&quot;http://www.cnblogs.com/peida/archive/2013/01/08/2850483.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这里&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;最后，我们将该配置文件提交到 cron 服务中&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ crontab /var/spool/cron/rootcron&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;检查一下是否已经成功将计划任务提交了&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ crontab -l&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果出现下面的提示，则说明已经成功提交了。自此，cron 会帮你打理好证书续期的事。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;$ crontab -l
# refetch https certificate per week
# minute hour day month week command
0 3 * * 2 /etc/cron.weekly/refetch-https-cer.sh &amp;gt;&amp;gt; /root/for_crontab/error.log&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Have fun ：）&lt;/p&gt;
&lt;h3 id=&quot;参考资料&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#参考资料&quot; title=&quot;参考资料&quot;&gt;&lt;/a&gt;参考资料&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://letsencrypt.org/getting-started/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Let’s Encrypt Getting Start&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://certbot.eff.org/#ubuntutrusty-nginx&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Certbot&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://www.jianshu.com/p/eaac0d082ba2&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Let’s Encrypt SSL证书配置&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://www.cnblogs.com/peida/archive/2013/01/08/2850483.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;每天一个linux命令（50）：crontab命令&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://outprog.github.io/blog/2015/10/15/ubuntu-14-dot-04-shi-yong-cron-shi-xian-ji-hua-ren-wu/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Ubuntu 14.04 使用 Cron 实现计划任务&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content:encoded></item><item><title>iOS 持续集成系列 - 自动化 Code Review</title><link>https://www.shengpan.net/blog/auto-code-review/</link><guid isPermaLink="true">https://www.shengpan.net/blog/auto-code-review/</guid><description>为了保证代码质量，Code Review 是非常重要的一环。细到 * 的位置是否正确，大到代码的结构是否符合了软件开发的一些基本原则，都在这项工作的范围内。</description><pubDate>Wed, 14 Sep 2016 00:00:00 GMT</pubDate><content:encoded>&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/blog/ios-ci-index/&quot;&gt;iOS 持续集成 - 开篇&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#&quot;&gt;iOS 持续集成 - 自动化 Code Review&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;[iOS 持续集成 - 自动化单元测试]&lt;/li&gt;
&lt;li&gt;[iOS 持续集成 - 自动化打包与分发]&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;为了保证代码质量，Code Review 是非常重要的一环。细到&lt;code&gt;*&lt;/code&gt;的位置是否正确，大到代码的结构是否符合了软件开发的一些基本原则，都在这项工作的范围内。&lt;/p&gt;
&lt;p&gt;受限于现实情况，大多数团队没有足够的时间进行 Code Review，那么只能把一部分 CR 工作交给计算机去完成了。我们只需要定下合理的流程，用代码告诉计算机需要做什么，剩下的就交给我们可靠的伙伴吧。&lt;/p&gt;
&lt;p&gt;应用了自动化 Code Review 后，如果你的代码写得不好，Xcode 会表示不开心。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/11/xcode.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;如果你忽略 Xcode 的心情，那么质量管理平台会默默地记录这一切。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/11/sonar.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;这套东西既帮助开发们写出更高质量的的代码，也给经理们对工程质量的评估提供了一个切面的支持，同时只需要花费较少的人力维护，听起来是不是跃跃欲试了呢 ： ）&lt;/p&gt;
&lt;h2 id=&quot;流程&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#流程&quot; title=&quot;流程&quot;&gt;&lt;/a&gt;流程&lt;/h2&gt;&lt;p&gt;整体的工作流程非常简单，如图：&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;自动化 Code Review 总体流程&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/11/flow-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;关键点在于&lt;strong&gt;本地 Review&lt;/strong&gt;和&lt;strong&gt;远端 Review&lt;/strong&gt;这两步。前者是提供给开发者一个即时的代码质量反馈，以便开发者修改，从而避免在接下来的远端 Review 中得到一个较低的得分。后者则是为了生成相关报表，为项目管理人员跟踪项目质量提供依据。在很多大公司里，这也是开发者们绩效的参考之一。&lt;/p&gt;
&lt;p&gt;剩下的就是一些胶水步骤了，如何让过程更自动化，就是胶水步骤要做的事。例如利用 WebHook 自动触发远端 Review，利用 Git 的钩子进行增量校验而不是全量校验等。这些我们放在后面聊，先来看看本地校验的流程。&lt;/p&gt;
&lt;h2 id=&quot;本地-Review&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#本地-Review&quot; title=&quot;本地 Review&quot;&gt;&lt;/a&gt;本地 Review&lt;/h2&gt;&lt;p&gt;&lt;img alt=&quot;本地自动化 Code Review&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/11/local-flow-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;在本地 Review 环节，开发者只需要像往常一样按下 CMD + B，然后只要静静地等待进度条读完，满屏的⚠️就会精确地指示出某一行的代码违反了哪条规则。此时开发者就可以根据代码规范进行对应修改。&lt;/p&gt;
&lt;p&gt;从按下按键到产生警告主要发生了这么几件事情：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;生成 compile_commands.json 文件&lt;/li&gt;
&lt;li&gt;OCLint 读取相关的 Rules，逐个扫描 compile_commands.json 中的 .m 文件&lt;/li&gt;
&lt;li&gt;OCLint 将生成的报告展示在 Xcode 上&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;实现本地 Review 的核心就是 OCLint 和 compile_commands.json文件&lt;/strong&gt;&lt;/p&gt;
&lt;h3 id=&quot;OCLint&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#OCLint&quot; title=&quot;OCLint&quot;&gt;&lt;/a&gt;OCLint&lt;/h3&gt;&lt;blockquote&gt;
&lt;p&gt;工欲善其事，必先利其器&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href=&quot;http://oclint.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;OCLint&lt;/a&gt; 是一个开源的，基于 Clang 用 C++ 编写而成的，可以用于 C、C++ 和 Objective-C 的静态代码分析器。它可以在扫描的过程中动态加载规则文件（Rules），因此可以实现非常灵活的，高度可自定义的代码分析方案。它几乎可以和大多数系统无缝集成，例如 Cmake、Bear、xcodebuild、xctool、Xcode、xcpretty、Jenkins CI、Travis CI 等。你可以在&lt;a href=&quot;http://docs.oclint.org/en/stable/guide/xcode.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这里&lt;/a&gt;找到如何将其和 Xcode 配合使用。&lt;/p&gt;
&lt;p&gt;最新版本的 OCLint 已经自带了 71 条 Rules，基本上都是先人宝贵的经验，比如&lt;a href=&quot;http://docs.oclint.org/en/stable/rules/basic.html#gotostatement&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这条禁用 goto 语句的 Rule&lt;/a&gt;，就是来源于 &lt;a href=&quot;https://en.wikipedia.org/wiki/Edsger_W._Dijkstra&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Edsger W. Dijkstra&lt;/a&gt; 1968 年的一篇&lt;a href=&quot;http://www.cs.utexas.edu/users/EWD/ewd02xx/EWD215.PDF&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;手稿&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;这 71 条 Rules 已经可以帮助我们避免一部分因书写习惯和语言误区而导致的问题，但是对于有完整编码规范的公司来说显然是不够的。我们必须要自己开发 Rules。&lt;/p&gt;
&lt;p&gt;幸运的是，OCLint 已经为我们准备好了一切。&lt;/p&gt;
&lt;p&gt;OCLint 提供了 Clang 和 &lt;a href=&quot;https://en.wikipedia.org/wiki/Abstract_syntax_tree&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;AST (Abstract Syntax Tree)&lt;/a&gt; 的一层封装，使我们不必对抽象语法树进行解析，只需要专注规则相关的逻辑开发即可。从其提供的接口中我们可以很明显地看出这一点。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// 遇到一元操作符
bool VisitUnaryOperator(UnaryOperator *node)

// 遇到二元操作符
bool VisitBinaryOperator(BinaryOperator *node)

// 遇到 Objective-C 的函数声明
bool VisitObjCMethodDecl(ObjCMethodDecl *node)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在开发好相关的规则后，打包成 dylib，就可以在分析的时候&lt;a href=&quot;http://docs.oclint.org/en/stable/manual/oclint.html#rule-loading-options&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;加载我们自己的 Rule 了&lt;/a&gt;。&lt;/p&gt;
&lt;h3 id=&quot;compile-commands-json&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#compile-commands-json&quot; title=&quot;compile_commands.json&quot;&gt;&lt;/a&gt;compile_commands.json&lt;/h3&gt;&lt;p&gt;compile_commands.json 是 Clang 定义的&lt;a href=&quot;http://clang.llvm.org/docs/JSONCompilationDatabase.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;一个规范&lt;/a&gt;，里面存放了一组&lt;strong&gt;工作目录&lt;/strong&gt;、&lt;strong&gt;目标文件&lt;/strong&gt;、&lt;strong&gt;需要被执行的命令&lt;/strong&gt;，帮助相关工具可以独立于编译系统来将源代码文件转换为 AST 并做对应的事。&lt;/p&gt;
&lt;p&gt;看文件内容会更直观一些：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;[
{
  &quot;directory&quot;: &quot;/path/to/project/&quot;, 
  &quot;command&quot;: &quot;/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -x ...&quot;, 
  &quot;file&quot;: &quot;/path/to/project/XXXViewController.m&quot;
},
...
]&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;OCLint 可以根据 compile_commands.json 中的内容，批量检查源代码文件。&lt;/p&gt;
&lt;h3 id=&quot;xcpretty&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#xcpretty&quot; title=&quot;xcpretty&quot;&gt;&lt;/a&gt;xcpretty&lt;/h3&gt;&lt;p&gt;还有一个点需要关注的是，如何生成 compile_commands.json 文件？&lt;/p&gt;
&lt;p&gt;最便捷的方式是使用 &lt;code&gt;oclint-xcodebuild&lt;/code&gt; 来生成。首先，利用xcodebuild 生成 xcodebuild.log 文件。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;xcodebuild | tee xcodebuild.log&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;然后利用 &lt;code&gt;oclint-xcodebuild&lt;/code&gt; 生成 compile_commands.json&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;oclint-xcodebuild&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;截至 Xcode 8.1，这种做法可以正确生成 json 文件。由于 OCLint 团队已经声称不再维护 oclint-xcodebuild , 因此可能在未来的某个 Xcode 版本中这个方法将不再适用。&lt;/p&gt;
&lt;p&gt;另一个推荐的方法是利用 &lt;a href=&quot;https://github.com/supermarin/xcpretty&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;xcpretty&lt;/a&gt; 。&lt;/p&gt;
&lt;p&gt;xcpretty 可以一句话生成 json 文件。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;xcodebuild | xcpretty -r json-compilation-database --output /path/to/compile_commands.json&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;使用本地-Review&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#使用本地-Review&quot; title=&quot;使用本地 Review&quot;&gt;&lt;/a&gt;使用本地 Review&lt;/h3&gt;&lt;p&gt;了解了这些工具后就很容易明白本地自动化 Code Review 是如何工作的，使用方式也非常容易理解了：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;首先在电脑本地安装好 OCLint 并拿到公司自定义的 Rules 文件&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://docs.oclint.org/en/stable/guide/xcode.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;在 Xcode 上配置好工程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;build 工程，等待结果显示在 Xcode 上。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;附一个我们团队的配置脚本供参考:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;source ~/.bash_profile
cd ${SRCROOT}
xcodebuild clean
xcodebuild | tee xcodebuild.log
oclint-xcodebuild
oclint-json-compilation-database \
-e Vendor \
-e Pods \
-- \
-max-priority-1 100000 \
-max-priority-2 100000 \
-max-priority-3 100000 \
-report-type xcode \
-R /path/to/rules&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;远端-Review&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#远端-Review&quot; title=&quot;远端 Review&quot;&gt;&lt;/a&gt;远端 Review&lt;/h2&gt;&lt;p&gt;&lt;img alt=&quot;远端自动化 Code Review&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/11/remote-flow-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;远端 Review 和 本地 Review 大体相似，区别在与引用构建的脚本的对象从 Xcode 变成了 Jenkins CI ，报告的展示者从 Xcode 变成了 SonarQube 。其流程是这样的：&lt;/p&gt;
&lt;p&gt;工程师通过 &lt;code&gt;git push&lt;/code&gt; 提交代码&lt;br/&gt;→ Web Hook 触发 &lt;strong&gt;Jenkins&lt;/strong&gt; 构建&lt;br/&gt;→ &lt;strong&gt;OCLint&lt;/strong&gt; 扫描代码生成PMD格式报告&lt;br/&gt;→ &lt;strong&gt;Sonar-runner&lt;/strong&gt; 读取报告并展现到 &lt;strong&gt;SonarQube&lt;/strong&gt;。&lt;/p&gt;
&lt;h3 id=&quot;CI-环境&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#CI-环境&quot; title=&quot;CI 环境&quot;&gt;&lt;/a&gt;CI 环境&lt;/h3&gt;&lt;p&gt;为了实现远端 Review ，服务端必须首先有一套 CI 环境。鉴于 iOS 的特殊性，服务器必须是 macOS 系统。CI 我们直接选择开源的 &lt;a href=&quot;https://jenkins-ci.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Jenkins&lt;/a&gt;，质量管理平台则选用开源的 &lt;a href=&quot;http://www.sonarqube.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;SonarQube&lt;/a&gt;。Jenkins 大名鼎鼎大家都非常熟悉了，SonarQube 则相对少的人了解。&lt;/p&gt;
&lt;p&gt;SonarQube 是一个质量管理平台，在 SonarQube 上，你可以看到一个项目的代码行数、文件数量、代码重复率、违反的代码规范、技术债时间等等指标。SonarQube 对 Java 的支持极度友好，提供了 &lt;strong&gt;SonarScanner&lt;/strong&gt; 可以直接对 Java 源代码进行扫描。Objective-C 就没有这么幸运了。虽然 SonarQube 也提供了 Objective-C 的报告展示的支持，但静态分析还是得依靠 OCLint 。&lt;/p&gt;
&lt;h3 id=&quot;Sonnar-Runner&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Sonnar-Runner&quot; title=&quot;Sonnar-Runner&quot;&gt;&lt;/a&gt;Sonnar-Runner&lt;/h3&gt;&lt;p&gt;我们在 Jenkins 上运行 OCLint 生成了报告。需要一个中间人将报告解析成 SonarQube 可以理解的格式并传输到 SonarQube 平台。这个中间人就是 Sonnar-Runner。Sonnar-Runner 在我们的系统中也仅仅扮演这个搬运工的角色。你可以从&lt;a href=&quot;http://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner+for+Jenkins&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这里&lt;/a&gt;了解到如何在 Jenkins 上安装和使用 Sonnar-Runner。&lt;/p&gt;
&lt;p&gt;Sonnar-Runner 只能解析 &lt;a href=&quot;http://pmd.github.io&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;PMD&lt;/a&gt; 格式的报告，因此我们在使用 OCLint 分析代码后，需要将报告格式&lt;a href=&quot;http://docs.oclint.org/en/stable/howto/selectreporters.html#pmd-reporter-pmd&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;输出为 PMD 格式&lt;/a&gt;。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;oclint -report-type pmd -o ./report.xml&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;Rules-in-Sonar&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Rules-in-Sonar&quot; title=&quot;Rules in Sonar&quot;&gt;&lt;/a&gt;Rules in Sonar&lt;/h3&gt;&lt;p&gt;SonarQube 有一套规则，将代码问题按照严重程度分为 5 个等级，不同等级的问题会以不同权重影响到项目质量评分。这套规则和 OCLint 生成的报告中的 Rule name 必须要一一对应，SonarQube 才能正确将报告中的问题归类并评分。&lt;/p&gt;
&lt;p&gt;如果你使用 OCLint 原生的 Rules 来检查代码，只需要在 SonarQube 上安装 &lt;a href=&quot;https://github.com/octo-technology/sonar-objective-c&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;SonarQube Plugin for Objective C&lt;/a&gt; 插件，相关的报告就会被正确识别了。&lt;/p&gt;
&lt;p&gt;如果是使用了自行开发的 Rules ，只需要 Clone 上述插件，并在&lt;strong&gt;profile-oclint.xml&lt;/strong&gt; 和 &lt;strong&gt;rules.txt&lt;/strong&gt; 中添加相关的 rule name ，然后打包并将这个插件安装到 SonarQube 上即可。&lt;/p&gt;
&lt;p&gt;举个例子：&lt;/p&gt;
&lt;p&gt;当我们用自行开发的 Rule 检查完代码后，生成了report.xml，内容如下：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;&amp;lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&amp;gt;
&amp;lt;pmd version=&quot;oclint-0.11&quot;&amp;gt;
    &amp;lt;file name=&quot;/path/to/TerribleCode.m&quot;&amp;gt;
        &amp;lt;violation rule=&quot;binary operator space (HT_iOS_Coding_style 2.8)&quot; begincolumn=&quot;9&quot; endcolumn=&quot;157&quot; beginline=&quot;73&quot; endline=&quot;73&quot; priority=&quot;3&quot; ruleset=&quot;HT_iOS_rules&quot; &amp;gt;
            多元运算符和他们的操作数之间至少需要一个空格
        &amp;lt;/violation&amp;gt;
    &amp;lt;/file&amp;gt;
&amp;lt;/pmd&amp;gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;其中 &lt;code&gt;binary operator space (HT_iOS_Coding_style 2.8)&lt;/code&gt; 是我们定义的错误rule name。在 SonarQube 上，也必须对应有这么一条 rule 的 name，才能正确识别这个错误。&lt;/p&gt;
&lt;p&gt;此时我们只需要在上述插件的 &lt;strong&gt;rules.txt&lt;/strong&gt; 中添加一段&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;binary operator space (HT_iOS_Coding_style 2.8)
----------

Summary:多元运算符和他们的操作数之间至少需要一个空格。 

Severity: 2
Category: Hengtian iOS Coding Standard&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在上述插件的 &lt;strong&gt;profile-oclint.xml&lt;/strong&gt; 中添加另外一段代码&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt; &amp;lt;rule&amp;gt;
  &amp;lt;repositoryKey&amp;gt;OCLint&amp;lt;/repositoryKey&amp;gt;
  &amp;lt;key&amp;gt;binary operator space (HT_iOS_Coding_style 2.8)&amp;lt;/key&amp;gt;
&amp;lt;/rule&amp;gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;然后将这个插件打包并安装到 SonarQube 上，SonarQube 就可以正确识别我们的问题并分类了。&lt;/p&gt;
&lt;h3 id=&quot;使用远端-Review&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#使用远端-Review&quot; title=&quot;使用远端 Review&quot;&gt;&lt;/a&gt;使用远端 Review&lt;/h3&gt;&lt;p&gt;在使用前，一定要确保你的 macOS 服务器已经安装好了最新版的 Xocde、OCLint、Jenkins、sonnar-runner，安装好 Jenkins 的相关插件，并将自定义的 Rule 放置在服务器上（如果有的话）。&lt;/p&gt;
&lt;h4 id=&quot;检查并生成报告&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#检查并生成报告&quot; title=&quot;检查并生成报告&quot;&gt;&lt;/a&gt;检查并生成报告&lt;/h4&gt;&lt;p&gt;在 Jenkins 上新建工程并配置好Git、构建触发器等其他内容。在构建步骤中添加一步 &lt;strong&gt;Execute Shell&lt;/strong&gt; ，填入下述脚本&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;cd YourProjectDir
xcodebuild clean
xcodebuild -workspace MyProject.xcworkspace -scheme HTMarket -sdk iphonesimulator | tee xcodebuild.log | xcpretty
oclint-xcodebuild
oclint-json-compilation-database -e Pods \
-v \
-- \
-max-priority-1 100000 \
-max-priority-2 100000 \
-max-priority-3 100000 \
-report-type pmd \
-R /path/to/diy-rules \
-o /path/to/report.xml&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;脚本大致和本地 Review 一致，有三个地方需要注意一下。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;xcodebuild&lt;/code&gt; 命令添加了 &lt;code&gt;-sdk iphonesimulator&lt;/code&gt;参数，以避免 build 需要 Code Sign 的问题。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-report-type pmd&lt;/code&gt; 输出格式必须为 pmd 格式&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-o /path/to/report.xml&lt;/code&gt; 注意输出报告的路径，下一步sonnar-runner 读取时会用到。&lt;/li&gt;
&lt;/ol&gt;
&lt;h4 id=&quot;读取到-SonarQube&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#读取到-SonarQube&quot; title=&quot;读取到 SonarQube&quot;&gt;&lt;/a&gt;读取到 SonarQube&lt;/h4&gt;&lt;p&gt;在上一步的下方再添加一步 &lt;strong&gt;Invoke Standalone SonarQube Analysis&lt;/strong&gt;，选择好你的 sonnar-runner。并在 &lt;em&gt;Analysis Properties&lt;/em&gt; 中添加如下配置：（如果没有这一项，你可能需要安装 SonarQube 相关的插件。）&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;sonar.projectKey=YOUR_PROJECT_NAME
sonar.projectName=YOUR_PROJECT_NAME
sonar.projectVersion=1.0
sonar.language=objc
sonar.projectDescription=YOUR_PROJECT_DESCRIPTION
 
# Path to source directories 
sonar.sources=/path/to/source/directories
 
# Xcode project configuration (.xcodeproj or .xcworkspace)
# -&amp;gt; If you have a project: configure only sonar.objectivec.project
# -&amp;gt; If you have a workspace: configure sonar.objectivec.workspace and sonar.objectivec.project
# and use the later to specify which project(s) to include in the analysis (comma separated list)
sonar.objectivec.project=YOUR_PROJECT_NAME.xcodeproj 
sonar.objectivec.workspace= YOUR_PROJECT_NAME.xcworkspace

# Scheme to build your application
sonar.objectivec.appScheme=YOUR_PROJECT_NAME
 
sonar.sourceEncoding=UTF-8

# OCLint report generated by run-sonar.sh is stored in sonar-reports/oclint.xml
# Change it only if you generate the file on your own
 sonar.objectivec.oclint.report=YOUR_REPORT_FILE_PATH&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;注意看注释并修改 &lt;code&gt;YOUR_PROJECT_NAME&lt;/code&gt; 、&lt;code&gt;YOUR_PROJECT_DESCRIPTION&lt;/code&gt;、和 &lt;code&gt;YOUR_REPORT_FILE_PATH&lt;/code&gt;为你项目的值。&lt;/p&gt;
&lt;p&gt;一切顺利的话，在 Jenkins 上立即构建，你就可以在你的 Sonar 平台上看到代码质量报告了。&lt;/p&gt;
&lt;p&gt;配合好&lt;strong&gt;构建触发器&lt;/strong&gt; 和 Git 平台的 WebHook 功能，就可以在开发提交代码或者合并分支等关键点自动触发构建了。&lt;/p&gt;
&lt;h3 id=&quot;Troubleshooting&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Troubleshooting&quot; title=&quot;Troubleshooting&quot;&gt;&lt;/a&gt;Troubleshooting&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;为什么生成的 compile_commands.json 为空&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;检查 log 是否为空，如果 log 为空则代表 build 失败。排除失败原因后即可正常生成。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Jenkins 构建遇到了如下问题&lt;/strong&gt;&lt;br/&gt;&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;❌  Code signing is required for product type &apos;Application&apos; in SDK &apos;iOS 10.0&apos;&lt;/code&gt;&lt;/pre&gt;&lt;/p&gt;
&lt;p&gt;遇到这样的情况，是因为构建了 Release 版本，且项目在 Xcode8+ 上开启了 Automatic Code Sign。解决方法如下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;如果只需要检查代码规范，则在 xcodebuild 命令后添加 &lt;code&gt;-sdk iphonesimulator&lt;/code&gt; 参数指明以 Debug 方式构建即可。&lt;/li&gt;
&lt;li&gt;如果希望构建 Release 版本，那么关闭自动签名，在 CI 系统上手动配置证书和Proversion Profile。或者保留自动签名，参考&lt;a href=&quot;https://testerhome.com/topics/5954&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这个回答&lt;/a&gt;用 &lt;code&gt;sed&lt;/code&gt; 命令在构建前修改相关配置。&lt;/li&gt;
&lt;/ol&gt;
&lt;h4 id=&quot;参考链接&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#参考链接&quot; title=&quot;参考链接&quot;&gt;&lt;/a&gt;参考链接&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;http://oclint.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;OCLint&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://jenkins-ci.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Jenkins&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://www.sonarqube.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;SonarQube&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://en.wikipedia.org/wiki/Edsger_W._Dijkstra&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Edsger W. Dijkstra&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://en.wikipedia.org/wiki/Abstract_syntax_tree&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;AST (Abstract Syntax Tree)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://clang.llvm.org/docs/JSONCompilationDatabase.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;json compilation database format specification&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/supermarin/xcpretty&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;xcpretty&lt;/a&gt; &lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://pmd.github.io&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;PMD&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://testerhome.com/topics/5954&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;xcode8 和 ios10 升级之后的问题集中讨论帖 – TesterHome&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content:encoded></item><item><title>深挖 Swift 中的字符串可比性</title><link>https://www.shengpan.net/blog/string-comparable/</link><guid isPermaLink="true">https://www.shengpan.net/blog/string-comparable/</guid><description>在写 《从 Swift 中的 max(_:_:) 看设计哲学》 的过程中，产生了这样一个想法: 既然 max(_:_:) 可以用来对比任何 Comparable ,而 String 是符合 Comparable 的，那么用它来比较两个字符串”谁大谁小</description><pubDate>Tue, 06 Sep 2016 00:00:00 GMT</pubDate><content:encoded>&lt;hr/&gt;
&lt;p&gt;在写 &lt;a href=&quot;/blog/swift-max/&quot;&gt;《从 Swift 中的 max(_:_:) 看设计哲学》&lt;/a&gt;的过程中，产生了这样一个想法: &lt;em&gt;既然 &lt;code&gt;max(_:_:)&lt;/code&gt; 可以用来对比任何 &lt;code&gt;Comparable&lt;/code&gt; ,而 &lt;code&gt;String&lt;/code&gt; 是符合 &lt;code&gt;Comparable&lt;/code&gt; 的，那么用它来比较两个字符串”谁大谁小”会怎么样呢？&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;由于实验结果的捉摸不定，于是产生了一探究竟的念头。过程很有趣，结果让人感叹计算机科学之深厚。同时也是典型的 &lt;strong&gt;How I Resolve A Problem&lt;/strong&gt;,故记。&lt;/p&gt;
&lt;h3 id=&quot;用-max-来对比-String&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#用-max-来对比-String&quot; title=&quot;用 max 来对比 String&quot;&gt;&lt;/a&gt;用 max 来对比 String&lt;/h3&gt;&lt;blockquote&gt;
&lt;p&gt;The Comparable protocol is used for types that have an inherent order, such as numbers and strings.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Swift 标准库已经为 Sting 实现了 Comparable， max 可以用在 String 上。猜猜下面两个字符串谁更大？&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;let maxString = max(&quot;bc&quot;, &quot;abc&quot;)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;答案是 &lt;strong&gt;maxString == “bc”&lt;/strong&gt;&lt;/p&gt;
&lt;h3 id=&quot;Why&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Why&quot; title=&quot;Why?&quot;&gt;&lt;/a&gt;Why?&lt;/h3&gt;&lt;p&gt;根据结果我们猜测，String 的大小应该不是根据长度来判断的，&lt;strong&gt;有可能是按照首字母的 Unicode 编码大小来判断的&lt;/strong&gt;。为了证实这一猜测，我们去翻翻相关资料。&lt;/p&gt;
&lt;p&gt;首先看 String 的头文件。&lt;/p&gt;
&lt;p&gt;我们只看到了实现了 Comparable 的声明。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;extension String : Equatable {
}

extension String : Comparable {
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;嗯。 好歹证实了 String 的确实现了 Comparable 嘛。既然 Swift 是开源的，我们去源代码里找找，继续深挖。&lt;/p&gt;
&lt;p&gt;首先 Google &lt;em&gt;swift standard library source code&lt;/em&gt;,&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/09/google-swift-std-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;我们访问 Swift 官网上的 Source Code 一节，其中中有两块资源可能会有我们的答案，一块是 &lt;strong&gt;&lt;a href=&quot;https://github.com/apple/swift&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Swift 源码&lt;/a&gt;&lt;/strong&gt; ,另一块是 &lt;strong&gt;&lt;a href=&quot;https://github.com/apple/swift-corelibs-foundation&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Foundation源码&lt;/a&gt;&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/09/swift-source-code.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;我们把两部分都 Clone 下来看看。&lt;/p&gt;
&lt;p&gt;首先看可以直接打开工程文件的 Foundation 源码，找到 String.swift 文件， 一共 70 行代码。类声明是这样的 &lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;extension String : _ObjectTypeBridgeable&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;原来这个工程是为了和 Objective - C 的库桥接而生的。看来只能到 Swift 源码中找答案了。&lt;/p&gt;
&lt;h3 id=&quot;去-Swift-源码中找答案&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#去-Swift-源码中找答案&quot; title=&quot;去 Swift 源码中找答案&quot;&gt;&lt;/a&gt;去 Swift 源码中找答案&lt;/h3&gt;&lt;p&gt;Swift 的 README 中有这么一句话&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Another source of documentation is the standard library itself, located in stdlib. Much of the language is actually implemented in the library (including Int)&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;既然这样，在 &lt;code&gt;stdlib&lt;/code&gt; 文件夹里面，肯定也有 &lt;code&gt;String&lt;/code&gt; 的实现。&lt;/p&gt;
&lt;p&gt;我们在 &lt;code&gt;stdlib/public/core&lt;/code&gt; 下找到 &lt;code&gt;String.Swift&lt;/code&gt; 并打开。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/09/string.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;如苹果所说，Swift 标准库的文档基本上都在原代码中了，&lt;strong&gt;开头整整 284 行都是文档&lt;/strong&gt;! Apple 的文档丰富和详细在这里提现得淋漓尽致。&lt;/p&gt;
&lt;p&gt;从上图也可以看到，我们尝试搜索 &lt;code&gt;Comparable&lt;/code&gt; 关键字，没有发现文件中有对 &lt;code&gt;Comparable&lt;/code&gt; 的实现。快速翻阅一下 String 的 extension, 也没有发现相关的实现。&lt;/p&gt;
&lt;p&gt;查阅 Apple 的 &lt;a href=&quot;https://developer.apple.com/reference/swift/comparable&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;API Reference&lt;/a&gt; 可以得知 &lt;code&gt;Comparable&lt;/code&gt; 也是 Swift 标准库的一份。因此，在上述文件夹中肯定能找到相关定义。同时，我们也知道，Swift 可以为 Protocol 添加默认实现。也许找到 &lt;code&gt;Comparable&lt;/code&gt; 定义的地方，就能找到答案。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/09/Comparable.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;在 String.swift 的同目录下，我们发现了 Comparable.swift 文件，打开文件，我们发现了熟悉的 &lt;code&gt;Comparable&lt;/code&gt; 协议的定义，以及最关键的，默认实现:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;public func &amp;gt; &amp;lt;T : Comparable&amp;gt;(lhs: T, rhs: T) -&amp;gt; Bool {
  return rhs &amp;lt; lhs
}

public func &amp;lt;= &amp;lt;T : Comparable&amp;gt;(lhs: T, rhs: T) -&amp;gt; Bool {
  return !(rhs &amp;lt; lhs)
}

public func &amp;gt;= &amp;lt;T : Comparable&amp;gt;(lhs: T, rhs: T) -&amp;gt; Bool {
  return !(lhs &amp;lt; rhs)
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;可以看到这里只有针对 &lt;code&gt;&amp;gt;&lt;/code&gt;，&lt;code&gt;&amp;lt;=&lt;/code&gt;,&lt;code&gt;&amp;gt;=&lt;/code&gt; 的实现，并且这些实现都是依赖 &lt;code&gt;&amp;lt;&lt;/code&gt; 的实现。这一点印证了接口文档中 Apple 关于&lt;a href=&quot;http://en.wikipedia.org/wiki/Total_order#Strict_total_order&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;严格全序&lt;/a&gt;和如何在子类实现 &lt;code&gt;Comparable&lt;/code&gt; 的说法。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;A type conforming to &lt;code&gt;Comparable&lt;/code&gt; need only supply the &lt;code&gt;&amp;lt;&lt;/code&gt; and&lt;code&gt;==&lt;/code&gt; operators;&lt;br/&gt;default implementations of &lt;code&gt;&amp;lt;=&lt;/code&gt;, &lt;code&gt;&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;gt;=&lt;/code&gt;, and&lt;code&gt;!=&lt;/code&gt; are supplied by the standard library&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id=&quot;走弯路&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#走弯路&quot; title=&quot;走弯路&quot;&gt;&lt;/a&gt;走弯路&lt;/h3&gt;&lt;p&gt;那么 &lt;code&gt;&amp;lt;&lt;/code&gt; 的实现又在哪儿？&lt;/p&gt;
&lt;p&gt;纵览 &lt;code&gt;Comparable&lt;/code&gt; 的源码中的文档，基本上是设计思想和使用说明，只字未提 &lt;code&gt;&amp;lt;&lt;/code&gt; 的实现。&lt;/p&gt;
&lt;p&gt;我们继续翻阅标准库中的文件，在 &lt;code&gt;optinal.swift&lt;/code&gt; 等文件中，都有对 &lt;code&gt;==&lt;/code&gt; 的重载，但 Command + 左键点击无法跳转到原始实现。一番寻找后，在 &lt;code&gt;Policy.swift&lt;/code&gt; 中找到 &lt;code&gt;&amp;lt;&lt;/code&gt; 的定义&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/09/-.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;似乎 &lt;code&gt;ComparisonPrecedence&lt;/code&gt; 是关键所在。由于是打开单个文件，无法点击跳转到 &lt;code&gt;ComparisonPrecedence&lt;/code&gt; 的定义。联想到 Swift 的 README 中说过，可以通过 &lt;code&gt;utils/build-script -x&lt;/code&gt; 来将源码构建成 Xcode 工程，那样看起来会方便许多。但考虑到需要安装 &lt;code&gt;CMake&lt;/code&gt;、&lt;code&gt;Ninja&lt;/code&gt; 等一系列环境，所花费的时间对于解决这个问题来说不划算。先去 Google 搜索一下答案。&lt;/p&gt;
&lt;p&gt;通过 Google 找到了 NSHipster 的 &lt;a href=&quot;http://nshipster.com/swift-operators/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Swift Operators&lt;/a&gt;,也仔细阅读了 &lt;a href=&quot;https://developer.apple.com/library/ios/documentation/Swift/Conceptual/Swift_Programming_Language/BasicOperators.html#//apple_ref/doc/uid/TP40014097-CH6-ID60&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;The Swift Programming Language (Swift 2.2)&lt;/a&gt;，均没有收获。&lt;/p&gt;
&lt;h3 id=&quot;转机&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#转机&quot; title=&quot;转机&quot;&gt;&lt;/a&gt;转机&lt;/h3&gt;&lt;p&gt;就在一筹莫展的时候，想到标准库的源码还没翻完，于是继续一个个地浏览标准库的文件。其中一个文件名让人眼前一亮:&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/09/StringComparable.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;我们找到了 String 关于 &lt;code&gt;Comparable&lt;/code&gt; 的实现！&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;extension String : Comparable {
  public static func &amp;lt; (lhs: String, rhs: String) -&amp;gt; Bool {
    return lhs._compareString(rhs) &amp;lt; 0
  }
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;String 的 &lt;code&gt;&amp;lt;&lt;/code&gt; 实现依赖于 &lt;code&gt;Int&lt;/code&gt; 的 &lt;code&gt;&amp;lt;&lt;/code&gt; 实现。通过 &lt;code&gt;_compareString&lt;/code&gt; 生成的整数和 0 比较。至此，我们忽然明白，&lt;strong&gt;Swift 标准库中，&lt;code&gt;Comparable&lt;/code&gt; 本身并没有提供默认的 &lt;code&gt;&amp;lt;&lt;/code&gt; 实现，而是由 &lt;code&gt;String&lt;/code&gt; 和 &lt;code&gt;Int&lt;/code&gt; 各自提供了 &lt;code&gt;&amp;lt;&lt;/code&gt; 的实现。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;整数的比较非常好理解了，我们来看看关键的 &lt;code&gt;_compareString&lt;/code&gt; 方法是怎么实现的&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;func _compareString(_ rhs: String) -&amp;gt; Int {
#if _runtime(_ObjC)
    // We only want to perform this optimization on objc runtimes. Elsewhere,
    // we will make it follow the unicode collation algorithm even for ASCII.
    if _core.isASCII &amp;amp;&amp;amp; rhs._core.isASCII {
      return _compareASCII(rhs)
    }
#endif
    return _compareDeterministicUnicodeCollation(rhs)
  }
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这个方法对 Objective-C 下的 ASCII 编码的字符串对比做了优化，剩余情况都采用 &lt;code&gt;_compareDeterministicUnicodeCollation&lt;/code&gt; 来做比较。&lt;/p&gt;
&lt;p&gt;顺藤摸瓜继续看 &lt;code&gt;_compareDeterministicUnicodeCollation&lt;/code&gt; 的实现。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;  func _compareDeterministicUnicodeCollation(_ rhs: String) -&amp;gt; Int {
    // Note: this operation should be consistent with equality comparison of
    // Character.
#if _runtime(_ObjC)
    if self._core.hasContiguousStorage &amp;amp;&amp;amp; rhs._core.hasContiguousStorage {
      let lhsStr = _NSContiguousString(self._core)
      let rhsStr = _NSContiguousString(rhs._core)
      let res = lhsStr._unsafeWithNotEscapedSelfPointerPair(rhsStr) {
        return Int(
            _stdlib_compareNSStringDeterministicUnicodeCollationPointer($0, $1))
      }
      return res
    }
    return Int(_stdlib_compareNSStringDeterministicUnicodeCollation(
      _bridgeToObjectiveCImpl(), rhs._bridgeToObjectiveCImpl()))
#else
    switch (_core.isASCII, rhs._core.isASCII) {
    case (true, false):
      return Int(_swift_stdlib_unicode_compare_utf8_utf16(
          _core.startASCII, Int32(_core.count),
          rhs._core.startUTF16, Int32(rhs._core.count)))
    case (false, true):
      // Just invert it and recurse for this case.
      return -rhs._compareDeterministicUnicodeCollation(self)
    case (false, false):
      return Int(_swift_stdlib_unicode_compare_utf16_utf16(
        _core.startUTF16, Int32(_core.count),
        rhs._core.startUTF16, Int32(rhs._core.count)))
    case (true, true):
      return Int(_swift_stdlib_unicode_compare_utf8_utf8(
        _core.startASCII, Int32(_core.count),
        rhs._core.startASCII, Int32(rhs._core.count)))
    }
#endif
  }&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;我们略过优化，直接看关键的两个方法： &lt;code&gt;_stdlib_compareNSStringDeterministicUnicodeCollationPointer&lt;/code&gt; 和 &lt;code&gt;_swift_stdlib_unicode_compare_utf8_utf8&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;看方法名，大概知道如下信息:&lt;/p&gt;
&lt;p&gt;在 Objective - C 下，比较两个 String 的 Unicode 集合指针。&lt;/p&gt;
&lt;p&gt;在 Swift 下，通过字符串的起始位置指针和字符串的长度综合比较。那么究竟是怎么综合比较的呢？（原来和长度还是有关系的，看来前面的猜测不全对）。&lt;/p&gt;
&lt;p&gt;通过方法名中&lt;code&gt;_swift_stdlib&lt;/code&gt;的前缀，我们猜测这个方法可能也是 Swift 标准库中的一员。经过一番查找，我们在 &lt;code&gt;/stdlib/public/stubs&lt;/code&gt; 路径下的 &lt;strong&gt;UnicodeNormalization.cpp&lt;/strong&gt; 文件的 173 行找到了这个方法。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/// Compares the strings via the Unicode Collation Algorithm on the root locale.
/// Results are the usual string comparison results:
///  &amp;lt;0 the left string is less than the right string.
/// ==0 the strings are equal according to their collation.
///  &amp;gt;0 the left string is greater than the right string.
int32_t
swift::_swift_stdlib_unicode_compare_utf8_utf8(const unsigned char *LeftString,
                                               int32_t LeftLength,
                                               const unsigned char *RightString,
                                               int32_t RightLength) {
  UCharIterator LeftIterator;
  UCharIterator RightIterator;
  UErrorCode ErrorCode = U_ZERO_ERROR;

  uiter_setUTF8(&amp;amp;LeftIterator, reinterpret_cast&amp;lt;const char *&amp;gt;(LeftString), LeftLength);
  uiter_setUTF8(&amp;amp;RightIterator, reinterpret_cast&amp;lt;const char *&amp;gt;(RightString), RightLength);

  uint32_t Diff = ucol_strcollIter(GetRootCollator(),
    &amp;amp;LeftIterator, &amp;amp;RightIterator, &amp;amp;ErrorCode);
  if (U_FAILURE(ErrorCode)) {
    swift::crash(&quot;ucol_strcollIter: Unexpected error doing utf8&amp;lt;-&amp;gt;utf8 string comparison.&quot;);
  }
  return Diff;
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;代码里的关键算法是 &lt;code&gt;ucol_strcollIter&lt;/code&gt;。但到这里，其实我们已经不再需要在源代码中继续翻找了，注释已经给出了答案 – &lt;strong&gt;通过 Unicode 对照算法来比较两个字符串，结果小于 0 ，则代表左边的字符串小于右边，反之亦然。如果结果等于 0 则代表两个字符串在该对照算法下是相等的。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;为了补充一下知识，我们再来看看 Unicode Collation Algorithm 的&lt;a href=&quot;http://unicode.org/reports/tr10/#Main_Algorithm&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;主算法&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;主算法分四步&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;标准化字符串&lt;/li&gt;
&lt;li&gt;为每个标准化后的字符串生成对照元素数组&lt;/li&gt;
&lt;li&gt;根据对照元素数组，生成二进制的排序 Key&lt;/li&gt;
&lt;li&gt;通过对比二进制数据的大小，其结果就是原字符串的”大小”。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;算法这块不过多展开, ucol_strcollIter 函数的实现看&lt;a href=&quot;http://icu-project.org/apiref/icu4c/ucol_8h.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这里&lt;/a&gt;，有兴趣的朋友可以深入研究。&lt;/p&gt;
&lt;h2 id=&quot;总结&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#总结&quot; title=&quot;总结&quot;&gt;&lt;/a&gt;总结&lt;/h2&gt;&lt;p&gt;Swift 下字符串的比较是通过计算机科学领域标准的 Unicode 对照算法来的。在不了解算法的情况下，很难从字面上看出两个字符串谁大谁小。因此在日常开发下，应当尽量避免比较两个字符串”谁大谁小”。&lt;/p&gt;
&lt;p&gt;Swift 以&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/Swift/Conceptual/Swift_Programming_Language/StringsAndCharacters.html#//apple_ref/doc/uid/TP40014097-CH7-ID285&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;&lt;strong&gt;是否具有统一码等价性&lt;/strong&gt;&lt;/a&gt; 作为判断字符相等的标准。因此在比较两个字符串相等的时候，也需要多考虑细，来避免产生不必要的 BUG。&lt;/p&gt;
&lt;hr/&gt;
&lt;h4 id=&quot;参考资料&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#参考资料&quot; title=&quot;参考资料&quot;&gt;&lt;/a&gt;参考资料&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/reference/swift/comparable&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Comparable&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/apple/swift&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Swift&lt;/a&gt;&lt;br/&gt;&lt;a href=&quot;https://github.com/apple/swift-corelibs-foundation&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Foundation&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://nshipster.com/swift-operators/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Swift Operators&lt;/a&gt; &lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/Swift/Conceptual/Swift_Programming_Language/BasicOperators.html#//apple_ref/doc/uid/TP40014097-CH6-ID60&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;The Swift Programming Language (Swift 2.2)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://unicode.org/reports/tr10/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Unicode Collation Algorithm&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://icu-project.org/apiref/icu4c/ucol_8h.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;ICU 57.1&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content:encoded></item><item><title>从 Swift 中的 max(_:_:) 看设计哲学</title><link>https://www.shengpan.net/blog/swift-max/</link><guid isPermaLink="true">https://www.shengpan.net/blog/swift-max/</guid><description>由于 Swift 不再支持宏了，于是 MAX,MIN 等一些列常用宏都被重写为 Swift 函数。我们来看看函数的定义:</description><pubDate>Mon, 05 Sep 2016 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;由于 Swift 不再支持宏了，于是 MAX,MIN 等一些列常用宏都被重写为 Swift 函数。我们来看看函数的定义:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;@warn_unused_result
public func max&amp;lt;T : Comparable&amp;gt;(x: T, _ y: T) -&amp;gt; T&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;warn-unused-result&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#warn-unused-result&quot; title=&quot;warn_unused_result&quot;&gt;&lt;/a&gt;&lt;code&gt;warn_unused_result&lt;/code&gt;&lt;/h3&gt;&lt;p&gt;先说说 @warn_unused_result 注解。 顾名思义，被该注解标记的方法所产生的返回值，如果未被使用，编译器会不开心哦（编译的时候会产生一条警告⚠️）。&lt;/p&gt;
&lt;p&gt;这里讲一下方法的设计哲学。一般来说一个理想的带有返回值的方法，除了返回返回值以外，是不会产生任何其他副作用的。比如说不会改变入参的值(这也是 &lt;code&gt;inout&lt;/code&gt;存在的原因)&lt;br/&gt;，不会对系统的其他状态有影响（比如说不会改变类的实例变量的值）。这样的好处是减少方法产生的不确定性，同时方法使用的目的变得非常明确。&lt;/p&gt;
&lt;p&gt;拿 &lt;code&gt;max&lt;/code&gt; 来举例。&lt;code&gt;max&lt;/code&gt; 方法被设计用来判断并返回两个参数中更大的那个。容易理解，当返回值没有被使用的时候，这次方法的调用也是没有意义的，因此 @warn_unused_result 的标注是非常合理的。&lt;/p&gt;
&lt;p&gt;所以当你在开发 SDK 或是框架，甚至是和同事合作开发业务，同事会用到你的 API 的时候，你可以在需要的地方，用此注解来标记你的方法，以提示使用者注意使用方法产生的返回值。&lt;/p&gt;
&lt;h3 id=&quot;面向协议&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#面向协议&quot; title=&quot;面向协议&quot;&gt;&lt;/a&gt;面向协议&lt;/h3&gt;&lt;p&gt;从方法的定义中，我们可以看到，传入的参数只要符合 &lt;code&gt;Comparable&lt;/code&gt; 协议，就可以正确得到返回结果。&lt;/p&gt;
&lt;p&gt;这意味着我们不仅可以用它来比较数字大小:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;let maxInteger = max(10, 20)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;还可以用来比较 &lt;code&gt;String&lt;/code&gt; 的大小&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;let maxString = max(&quot;bc&quot;, &quot;abc&quot;)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;甚至是自定义的对象，只要它实现了 &lt;code&gt;Comparable&lt;/code&gt; 协议。从这一点上，我们可以窥见 Swift “面向协议编程” 的一斑。面向协议编程让 &lt;code&gt;max(_:_:)&lt;/code&gt; 从具体的类中解放出来，不关心入参是什么类，有什么结构，只关心 &lt;strong&gt;所传进来的参数能否被比较&lt;/strong&gt;,而具体的比较则让入参自己去做，从而让 &lt;code&gt;max(_:_:)&lt;/code&gt; 具有普适性，达到程序设计上的低耦合。&lt;/p&gt;
&lt;p&gt;这么说可能有点抽象，我们来举个具体的例子。&lt;/p&gt;
&lt;p&gt;假设我们有这样的餐馆定义&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;struct Restaurant {
    var area: Int // 占地面积
    var michelinRate: Int // 米其林等级
    var averageCoast: Int // 人均消费
    var name: String // 餐厅名称
    var logo: UIImage // 餐厅LOGO
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;如何比较两家餐馆谁大谁小？&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;按照餐馆面积比，平海路上的日料店表示不服；按照人均消费比，新白鹿表示不服；按照米其林等级比，一众特色小吃店表示不服；按照餐厅名称长度比，产品经理表示不服。&lt;/p&gt;
&lt;p&gt;总地来说，”谁更大”其实是一种抽象的概念， &lt;code&gt;max&lt;/code&gt; 方法不能也不该知道入参是如何比较的。只有入参自己知道自己该如何比较。因此抽象出 &lt;code&gt;Comparable&lt;/code&gt; 协议是非常自然的。&lt;/p&gt;
&lt;h3 id=&quot;Comparable&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Comparable&quot; title=&quot;Comparable&quot;&gt;&lt;/a&gt;Comparable&lt;/h3&gt;&lt;p&gt;我们再来看看 &lt;code&gt;Comparable&lt;/code&gt; 的定义&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;public protocol Comparable : Equatable {
    /// over instances of `Self`.
    @warn_unused_result
    public func &amp;lt;(lhs: Self, rhs: Self) -&amp;gt; Bool
    @warn_unused_result
    public func &amp;lt;=(lhs: Self, rhs: Self) -&amp;gt; Bool
    @warn_unused_result
    public func &amp;gt;=(lhs: Self, rhs: Self) -&amp;gt; Bool
    @warn_unused_result
    public func &amp;gt;(lhs: Self, rhs: Self) -&amp;gt; Bool
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;Comparable&lt;/code&gt; 抽象了数学上&lt;a href=&quot;http://en.wikipedia.org/wiki/Total_order#Strict_total_order&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;严格全序&lt;/a&gt;的概念。虽然定义了五个方法(别忘了 Equatable 中还有一个 ==),但只需要实现 &lt;code&gt;==&lt;/code&gt; 和 &lt;code&gt;&amp;lt;&lt;/code&gt; ，其他方法只需要使用 Swift 标准库提供的默认实现，就可以根据严格全序定义推导出实现。&lt;/p&gt;
&lt;p&gt;数学真是计算机科学的基石啊！&lt;/p&gt;</content:encoded></item><item><title>iOS 持续集成系列 - 开篇</title><link>https://www.shengpan.net/blog/ios-ci-index/</link><guid isPermaLink="true">https://www.shengpan.net/blog/ios-ci-index/</guid><description>iOS 开发在经过这几年的野蛮生长之后，慢慢地趋于稳定。无论开发语言是 Objective-C 还是 Swift,工程类型是 Hybird 还是原生，开发思想是 OOP 还是函数式，随着项目逐渐变大都在面临相同的问题: 测试、发布等重复性工作占了很大</description><pubDate>Sun, 04 Sep 2016 00:00:00 GMT</pubDate><content:encoded>&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#&quot;&gt;iOS 持续集成 - 开篇&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/auto-code-review/&quot;&gt;iOS 持续集成 - 自动化 Code Review&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;[iOS 持续集成 - 自动化单元测试]&lt;/li&gt;
&lt;li&gt;[iOS 持续集成 - 自动化打包与分发]&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;前言&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#前言&quot; title=&quot;前言&quot;&gt;&lt;/a&gt;前言&lt;/h2&gt;&lt;p&gt;iOS 开发在经过这几年的野蛮生长之后，慢慢地趋于稳定。无论开发语言是 Objective-C 还是 Swift,工程类型是 Hybird 还是原生，开发思想是 OOP 还是函数式，随着项目逐渐变大都在面临相同的问题: 测试、发布等重复性工作占了很大一部分时间，回归成本越来越高。持续集成不可避免地被提上了日程。&lt;/p&gt;
&lt;p&gt;本文主要阐述 iOS 下的持续集成，以目标、内容、流程、工具入手，希望可以为大家描绘一幅 iOS 持续集成的蓝图。这可能不是一篇可以让你 Step by Step 跟着做的文章，但愿可以在你脑海中建立相关概念，以便在实操时走对方向。&lt;/p&gt;
&lt;p&gt;我们会在后面几篇内容中，详细阐述 &lt;strong&gt;是什么&lt;/strong&gt; 和 &lt;strong&gt;如何做&lt;/strong&gt; 。&lt;/p&gt;
&lt;h2 id=&quot;目标&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#目标&quot; title=&quot;目标&quot;&gt;&lt;/a&gt;目标&lt;/h2&gt;&lt;p&gt;对于我们来说，减少重复工作、提升团队效率。&lt;br/&gt;对于公司来说，省钱！&lt;/p&gt;
&lt;p&gt;狭义上持续集成指早集成早测试尽早早发现问题早修复，并辅以一些自动化的手段，其目标是减少修复的成本。通过其目的，我们可以发现，其实&lt;strong&gt;通过自动化减少重复工作&lt;/strong&gt;和&lt;strong&gt;通过早发现问题降低成本&lt;/strong&gt;是持续集成的核心理念。因此，我把自动化 Code Review 也放到这里讲。&lt;/p&gt;
&lt;h2 id=&quot;内容&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#内容&quot; title=&quot;内容&quot;&gt;&lt;/a&gt;内容&lt;/h2&gt;&lt;p&gt;iOS 下的持续集成内容包括自&lt;strong&gt;动化 Code Reivew、自动化单元测试、自动化打包和自动化分发&lt;/strong&gt;。自动化 Code Review 保证团队遵守代码规范，在编码阶段减少 BUG 的产生。在人员流动较大的公司里，用同一套代码规范，也可以保证项目交接更流畅。自动化单元测试在集成阶段检测出 BUG ,以减少回归成本。自动化打包和自动化分发则是减少重复劳动，毕竟，工程师的时间就是金钱啊。&lt;/p&gt;
&lt;h4 id=&quot;自动化-Code-Review&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#自动化-Code-Review&quot; title=&quot;自动化 Code Review&quot;&gt;&lt;/a&gt;自动化 Code Review&lt;/h4&gt;&lt;p&gt;顾名思义，自动化 Code Review 既采用自动化的手段，对团队成员得代码进行 Review，以保证代码质量。从现实角度来说，自动化的 Code Review 更多地是对代码进行静态分析，通过扫描代码并对比制定的规则，产出所需要的结果。这个所需要的结果，可以是工程总体的量化的质量报告，也可以是显示在 Xcode 中的一条警告⚠️。这取决于用户是什么角色。&lt;/p&gt;
&lt;p&gt;在实际实践中，一般会有两种角色会关注这份结果 – &lt;strong&gt;工程师和管理层&lt;/strong&gt;。工程师需要在开发的过程中及时了解代码错误，以便及时纠正。管理层需要了解工程的总体代码质量，以掌握项目的相关风险。同时，也可以作为工程师绩效的依据之一。&lt;/p&gt;
&lt;p&gt;要完成这一块内容，我们需要这些工具:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://jenkins-ci.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Jenkins&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://www.sonarqube.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;SonarQube&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://oclint.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;OCLint&lt;/a&gt; OR &lt;a href=&quot;https://github.com/realm/SwiftLint&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;SwiftLint&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;通过这三者协作，我们可以实现以下流程:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;工程师通过 `Git Commit` 提交代码 → Web Hook 触发 `Jenkins` 构建 → `OCLint` 扫描代码生成PMD格式报告 → `Sonar-runner` 读取报告并展现到 `SonarQube`。&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;关于 Code Review 需要指出的是，自动化工具是有局限性的。其无法分析出较为”智能”的规则。比如说下面这条&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;4.7 方法名以小写字母动词作为开头&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;还有下面这种代码，尽管含有多个容易造成闪退的 BUG,也是可以顺利逃过分析器的眼睛的&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;if result?.bindPhone == &quot;true&quot; {
	let range = (result?.loginId?.startIndex.advancedBy(3))!...(result?.loginId?.endIndex.advancedBy(-5))!
	let phoneNumber: String? = result?.loginId?.stringByReplacingCharactersInRange(range, withString: &quot;****&quot;)
	self.phoneNumLabel.text = phoneNumber!
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;因此，想要达到 “保证代码质量” 的目的，还需要人工 Review 和自动化 Review 相结合。&lt;/p&gt;
&lt;h4 id=&quot;自动化单元测试&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#自动化单元测试&quot; title=&quot;自动化单元测试&quot;&gt;&lt;/a&gt;自动化单元测试&lt;/h4&gt;&lt;p&gt;自动化地执行单元测试，在测试失败的情况下中断集成，并通知相关人员，就是这一块工作的内容。&lt;/p&gt;
&lt;p&gt;为此，我们需要如下的工具:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://jenkins-ci.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Jenkins&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/facebook/xctool&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;xctool&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;我们可以实现以下的流程:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;`Git Merge`  → Web Hook 触发 `Jenkins` 构建 → xctool 执行单元测试 → 如果失败则发邮件给相关人员。&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;当然，如果你公司的项目托管在 GitHub 上，业界有两个非常优秀的 Jenkins 替代产品 &lt;a href=&quot;https://travis-ci.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;travis-ci&lt;/a&gt; 和 &lt;a href=&quot;https://circleci.com&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;circle-ci&lt;/a&gt;。他们对 GitHub 的支持完美，且对开源项目是免费的。私有项目则需要付费试用。&lt;/p&gt;
&lt;p&gt;在单元测试这一块，最高的成本还是写单元测试的时间成本。脑洞大开地说，如果能实现一款工具，可以自动地为业务代码生成测试代码，那才是生产力的大大提升。&lt;/p&gt;
&lt;h4 id=&quot;自动化打包与分发&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#自动化打包与分发&quot; title=&quot;自动化打包与分发&quot;&gt;&lt;/a&gt;自动化打包与分发&lt;/h4&gt;&lt;p&gt;一次完整的打包，需要经历配置证书、切换环境、调整参数(构建版本号等)、Archive、导出。&lt;br/&gt;根据工程的复杂程度，以上过程快则五分钟，慢则半小时。当需要频繁发版的情况下，浪费了工程师非常多的时间。&lt;/p&gt;
&lt;p&gt;我们其实可以利用一些工具来实现这样的一个流程:&lt;/p&gt;
&lt;p&gt;Git Merge 到 Master（通常这意味着一个 Release）→ 触发 Jenkins 构建生成 ipa → &lt;strong&gt;自动化分发&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;自动分发包含以下工作：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;自动上传 App Store&lt;/li&gt;
&lt;li&gt;自动使用 TestFlight 分发&lt;/li&gt;
&lt;li&gt;自动上传到 蒲公英/Fir 等平台&lt;/li&gt;
&lt;li&gt;自动上传到企业 App Store&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;我们可以分别配置相关的脚本，来实现测试的分发，和发布等。&lt;/p&gt;
&lt;p&gt;要实现这样的流程，我们需要这些工具:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://jenkins-ci.org&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Jenkins&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://fastlane.tools&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Fastlane&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Fastlane 是由一个个小组件组成的工具，功能包括上传截图到 iTunes Connect,创建 provisioning file, 管理 TestFlight 的测试员，分发等。这个工具几乎可以用命令行来实现打包上传分发相关的所有功能，并且越来越有成为默认的业界持续集成标准工具的样子。就像 CocoaPods 在依赖管理方面一样。&lt;/p&gt;
&lt;h2 id=&quot;总结&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#总结&quot; title=&quot;总结&quot;&gt;&lt;/a&gt;总结&lt;/h2&gt;&lt;p&gt;持续集成，可以看做是通过版本控制系统、CI平台(如Jenkins)和相关工具链来完成一套工作流，以减少团队重复性工作，并保证软件可以不停地迭代而不出太大的差错。iOS 下的持续集成大体就是上述几块内容，我们在实现的过程中遇到了不少坑，后面的文章分块详细讲。&lt;/p&gt;</content:encoded></item><item><title>微信 URL Schemes</title><link>https://www.shengpan.net/blog/wechat-url/</link><guid isPermaLink="true">https://www.shengpan.net/blog/wechat-url/</guid><description>2016年09月18日更新：</description><pubDate>Tue, 12 Jul 2016 00:00:00 GMT</pubDate><content:encoded>&lt;h3 id=&quot;DEPRECATED&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#DEPRECATED&quot; title=&quot;DEPRECATED&quot;&gt;&lt;/a&gt;DEPRECATED&lt;/h3&gt;&lt;p&gt;2016年09月18日更新：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;在 微信 6.3.25 版本中，所有外部唤起 URL 的方式均无法打开对应页面。&lt;/strong&gt;&lt;br/&gt;未来这些 url 都只能在微信内部的浏览器使用了。&lt;/p&gt;
&lt;hr/&gt;
&lt;p&gt;年初的动态化分享热潮里，基本上都提到了 URL 跳转，天猫称为&lt;a href=&quot;http://pingguohe.net/2015/11/24/Navigator-and-Rewrite.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;统跳协议&lt;/a&gt;，蘑菇街称为 &lt;a href=&quot;http://limboy.me/tech/2016/03/10/mgj-components.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;URL 路由&lt;/a&gt;。其实很多大厂都默默地做了一套 URL 跳转机制，比如说 – 微信。&lt;/p&gt;
&lt;p&gt;本文整理了部分微信 URL Schemes，经过本人测试，所有url在微信 6.3.22 版本下都可正常工作。大家可以在 Safari 中打开链接进行尝试。(部分链接仅允许在微信内部浏览器中打开，已用&lt;code&gt;!&lt;/code&gt;标注。）&lt;/p&gt;
&lt;h3 id=&quot;微信&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#微信&quot; title=&quot;微信&quot;&gt;&lt;/a&gt;微信&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;微信 &lt;a href=&quot;weixin://&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;!&lt;/code&gt;发起群聊 &lt;a href=&quot;weixin://dl/groupchat&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/groupchat&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;通讯录&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#通讯录&quot; title=&quot;通讯录&quot;&gt;&lt;/a&gt;通讯录&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;!&lt;/code&gt;添加朋友 &lt;a href=&quot;weixin://dl/add&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/add&lt;/a&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;上报日志 &lt;a href=&quot;weixin://dl/log&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/log&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;故障修复 搜索 &lt;code&gt;:recover&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;新的朋友 &lt;a href=&quot;weixin://dl/recommendation&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/recommendation&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;群聊 &lt;a href=&quot;weixin://dl/groups&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/groups&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;标签 &lt;a href=&quot;weixin://dl/tags&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/tags&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;公众号 &lt;a href=&quot;weixin://dl/officialaccounts&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/officialaccounts&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;发现&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#发现&quot; title=&quot;发现&quot;&gt;&lt;/a&gt;发现&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;朋友圈 &lt;a href=&quot;weixin://dl/moments&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/moments&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;扫一扫 &lt;a href=&quot;weixin://dl/scan&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/scan&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;购物（京东） &lt;a href=&quot;weixin://dl/shopping&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/shopping&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;游戏 &lt;a href=&quot;weixin://dl/games&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/games&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;我&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#我&quot; title=&quot;我&quot;&gt;&lt;/a&gt;我&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;个人信息 &lt;a href=&quot;weixin://dl/profile&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/profile&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;名字 &lt;a href=&quot;weixin://dl/setname&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/setname&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;我的二维码 &lt;a href=&quot;weixin://dl/myQRcode&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/myQRcode&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;我的地址 &lt;a href=&quot;weixin://dl/myaddress&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/myaddress&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;相册 &lt;a href=&quot;weixin://dl/posts&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/posts&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;收藏 &lt;a href=&quot;weixin://dl/favorites&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/favorites&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;优惠券 &lt;a href=&quot;weixin://dl/card&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/card&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;表情 &lt;a href=&quot;weixin://dl/stickers&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/stickers&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;设置 &lt;a href=&quot;weixin://dl/settings&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/settings&lt;/a&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;QQ 号 &lt;a href=&quot;weixin://dl/bindqq&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/bindqq&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;手机号 &lt;a href=&quot;weixin://dl/bindmobile&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/bindmobile&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;邮箱地址 &lt;a href=&quot;weixin://dl/bindemail&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/bindemail&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;帐号保护 &lt;a href=&quot;weixin://dl/protection&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/protection&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;新消息通知 &lt;a href=&quot;weixin://dl/notifications&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/notifications&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;通讯录黑名单 &lt;a href=&quot;weixin://dl/blacklist&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/blacklist&lt;/a&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;不让他（她）看我的朋友圈 &lt;a href=&quot;weixin://dl/hidemoments&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/hidemoments&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;不看他（她）的朋友圈 &lt;a href=&quot;weixin://dl/blockmoments&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/blockmoments&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;通用 &lt;a href=&quot;weixin://dl/general&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/general&lt;/a&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;多语言 &lt;a href=&quot;weixin://dl/languages&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/languages&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;字体大小 &lt;a href=&quot;weixin://dl/textsize&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/textsize&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;我的表情 &lt;a href=&quot;weixin://dl/stickersetting&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/stickersetting&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;朋友圈小视频 &lt;a href=&quot;weixin://dl/sight&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/sight&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;功能 &lt;a href=&quot;weixin://dl/features&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/features&lt;/a&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;通讯录同步助手 &lt;a href=&quot;weixin://dl/securityassistant&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/securityassistant&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;群发助手 &lt;a href=&quot;weixin://dl/broadcastmessage&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/broadcastmessage&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;聊天记录迁移 &lt;a href=&quot;weixin://dl/chathistory&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/chathistory&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;清理微信存储空间 &lt;a href=&quot;weixin://dl/clear&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/clear&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;帮助与反馈&lt;ul&gt;
&lt;li&gt;意见反馈 &lt;a href=&quot;weixin://dl/help&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/help&lt;/a&gt; 或 &lt;a href=&quot;weixin://dl/feedback&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/feedback&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;关于微信 &lt;a href=&quot;weixin://dl/about&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/about&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;其他&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#其他&quot; title=&quot;其他&quot;&gt;&lt;/a&gt;其他&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;隐藏入口&lt;/strong&gt; 第三方公众号临时会话接口 &lt;a href=&quot;weixin://dl/business&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/business&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;参数 &lt;code&gt;ticket&lt;/code&gt; &lt;a href=&quot;weixin://dl/business/?ticket=&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/business/?ticket=&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;参阅：&lt;a href=&quot;http://xyk.cmbchina.com/wx/20150528&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;http://xyk.cmbchina.com/wx/20150528&lt;/a&gt; 使用了 &lt;a href=&quot;http://xyk.cmbchina.com/getWeiXinURL.do&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;http://xyk.cmbchina.com/getWeiXinURL.do&lt;/a&gt; 生成 ticket 参数&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;隐藏入口&lt;/strong&gt; &lt;code&gt;参数不明&lt;/code&gt; 第三方 Webview 接口 &lt;a href=&quot;weixin://dl/businessWebview/link/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/businessWebview/link/&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;隐藏入口&lt;/strong&gt; &lt;code&gt;参数不明&lt;/code&gt; 第三方游戏库接口 &lt;a href=&quot;weixin://dl/businessGame/library/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/businessGame/library/&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;隐藏入口&lt;/strong&gt; &lt;code&gt;参数不明&lt;/code&gt; 第三方游戏详情接口 &lt;a href=&quot;weixin://dl/businessGame/detail/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/businessGame/detail/&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;隐藏入口&lt;/strong&gt; &lt;code&gt;参数不明&lt;/code&gt; 第三方支付接口 &lt;a href=&quot;weixin://dl/businessPay/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/businessPay/&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;隐藏入口&lt;/strong&gt; &lt;code&gt;参数不明&lt;/code&gt; 第三方临时会话接口 &lt;a href=&quot;weixin://dl/business/tempsession/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/business/tempsession/&lt;/a&gt; 或 &lt;a href=&quot;weixin://dl/businessTempSession/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/businessTempSession/&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;未知&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#未知&quot; title=&quot;未知&quot;&gt;&lt;/a&gt;未知&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/chat&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/chat&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/designeremoji&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/designeremoji&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/login/common_view&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/login/common_view&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/login/phone_view&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/login/phone_view&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/personalemoticon&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/personalemoticon&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://private/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://private/&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;weixin://private/setresult/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://private/setresult/&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/update_newest_version&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/update_newest_version&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/wechatout&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/wechatout&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;weixin://dl/wechatoutcoupon&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;weixin://dl/wechatoutcoupon&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;参考资料:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/reverseengineeringer/com.tencent.mm/blob/master/src/com/tencent/mm/pluginsdk/d.java&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Wechat 安卓版部分源码&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://spacekid.me/weixin-url-schemes&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;太空小孩&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content:encoded></item><item><title>让你的应用更好地利用 3D Touch - WWDC 2016 Session 228 笔记</title><link>https://www.shengpan.net/blog/3dtouch/</link><guid isPermaLink="true">https://www.shengpan.net/blog/3dtouch/</guid><description>我们回首 iPhone 的历程，不禁感叹它是如何不断改变我们对手机的认知的。从触屏改变手机的定义开始，距离传感器、光线传感器，到三轴陀螺仪、GPS、运动传感器、再到指纹。这些功能一步步地拓展 iPhone 的能力，不断地改变着我们的生活。</description><pubDate>Thu, 23 Jun 2016 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;我们回首 iPhone 的历程，不禁感叹它是如何不断改变我们对手机的认知的。从触屏改变手机的定义开始，距离传感器、光线传感器，到三轴陀螺仪、GPS、运动传感器、再到指纹。这些功能一步步地拓展 iPhone 的能力，不断地改变着我们的生活。&lt;/p&gt;
&lt;p&gt;iPhone 6s 再次增加了新的功能 – 3D Touch。 它为iOS 设备的操作增加了另一个维度的能力，为用户提供了另一个操作体验，甚至是改变了用户的操作习惯。随着设备的普及和软件的跟进，3D Touch 也许会像指纹解锁一样，不可或缺的存在。&lt;/p&gt;
&lt;p&gt;关于 3D Touch, Apple 主要为我们提供了两种封装好的功能：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;主屏幕快捷菜单 ( Home screen quick action)&lt;/li&gt;
&lt;li&gt;预览 ( peek and pop )&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;Home-screen-quick-action&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Home-screen-quick-action&quot; title=&quot;Home screen quick action&quot;&gt;&lt;/a&gt;Home screen quick action&lt;/h3&gt;&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/06/IMG_0001-1.jpg&quot;/&gt;&lt;/p&gt;
&lt;p&gt;Home screen quick action 的表现形式非常简单，利用 3D Touch 按主屏幕图标，则会弹出该App 的快捷菜单。点击快捷菜单则会唤起app，并进入到相对应的功能。&lt;/p&gt;
&lt;p&gt;主屏幕快捷菜单分为&lt;strong&gt;静态&lt;/strong&gt;和&lt;strong&gt;动态&lt;/strong&gt;的两种。静态即固定的菜单。动态则代表菜单项是可变的。例如激活一款聊天软件的 Quick Action，出现三个你联系最频繁的人。这便需要动态菜单来实现。&lt;/p&gt;
&lt;p&gt;当然，他们的开发也同表现形式一样简单。&lt;/p&gt;
&lt;h4 id=&quot;静态快捷菜单&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#静态快捷菜单&quot; title=&quot;静态快捷菜单&quot;&gt;&lt;/a&gt;静态快捷菜单&lt;/h4&gt;&lt;p&gt;创建一个静态的快捷菜单，只需要简单地在&lt;code&gt;Info.plist&lt;/code&gt;中添加一个 &lt;code&gt;UIApplicationShortcutItems&lt;/code&gt; 的 Array 即可。&lt;/p&gt;
&lt;p&gt;你可以为快捷菜单指定标题、系统或自定义的icon等，所有这些，都只需要在 &lt;code&gt;UIApplicationShortcutItems&lt;/code&gt; 下添加一些key 和 value 即可。这些key可以在&lt;a href=&quot;https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW32&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这里&lt;/a&gt;找到。&lt;/p&gt;
&lt;p&gt;iOS 10 中，快捷菜单同时可以附带显示一个 Widget ，也就是以前的 App Extension。如果你提供了多个 Extension，可以在 &lt;code&gt;Info.plist&lt;/code&gt; 中添加 &lt;code&gt;UIApplicationShortcutWidget&lt;/code&gt;，其 Value 代表快捷菜单中展示的 Extension 的 Bundle id. &lt;/p&gt;
&lt;h4 id=&quot;动态快捷菜单&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#动态快捷菜单&quot; title=&quot;动态快捷菜单&quot;&gt;&lt;/a&gt;动态快捷菜单&lt;/h4&gt;&lt;p&gt;创建一个动态的快捷菜单也非常容易，只需要初始化并配置   &lt;code&gt;UIApplicationShortcutItem&lt;/code&gt;, &lt;code&gt;UIMutableApplicationShortcutItem&lt;/code&gt; 和 &lt;code&gt;UIApplicationShortcutIcon&lt;/code&gt; 这三个类，并将其添加到 AppDelegate 中的 &lt;code&gt;shortcutItems&lt;/code&gt; 属性即可。&lt;/p&gt;
&lt;p&gt;值得一提的是，静态快捷菜单在 App 被安装的那一刻就可用了。区别于静态菜单，动态快捷菜单只有当第一次启动后才可用。&lt;/p&gt;
&lt;h4 id=&quot;处理快捷菜单的点击&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#处理快捷菜单的点击&quot; title=&quot;处理快捷菜单的点击&quot;&gt;&lt;/a&gt;处理快捷菜单的点击&lt;/h4&gt;&lt;p&gt;这里分&lt;em&gt;当 App 被 kill&lt;/em&gt; 和 &lt;em&gt;当 App 未被 kill&lt;/em&gt;两种情况。&lt;/p&gt;
&lt;p&gt;当 App 仍然在运行的情况下，点击快捷菜单会触发以下方法：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;func application(_ application: UIApplication, performActionFor shortcutItem: UIApplicationShortcutItem, completionHandler: (Bool) -&amp;gt; Void) {
	// 做你想做的事
	// 最后不要忘了调用completionHandler()
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;当 App 被 kill 的情况下，点击快捷菜单会触发以下方法：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -&amp;gt; Bool {
	// 通过 UIApplicationLaunchOptionsShortcutItemKey 在 launchOptions 中取得 UIApplicationShortcutItem
	// 然后做你想做的事
}&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;Peek-and-Pop&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Peek-and-Pop&quot; title=&quot;Peek and Pop&quot;&gt;&lt;/a&gt;Peek and Pop&lt;/h3&gt;&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/06/IMG_0002-1.jpg&quot;/&gt;&lt;/p&gt;
&lt;p&gt;macOS 中按下空格键即可预览各种各样的文件。通过 3D Touch 现在它也来到了 iOS 中。这一操作被 Apple 很形象地称为 &lt;strong&gt;Peek and Pop&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;Peek and Pop 将传统的 Push 操作分为了两步，当你的手指按压某行列表，背景开始模式模糊，然后出现一个预览界面，然后继续增加压力，伴随着俏皮的弹性动画，下一个界面呈现在你眼前。在 API 中，这两部分别被称为 &lt;code&gt;Preview&lt;/code&gt; 和 &lt;code&gt;Commit&lt;/code&gt;。 &lt;/p&gt;
&lt;h4 id=&quot;为你的-App-添加-Peek-and-Pop&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#为你的-App-添加-Peek-and-Pop&quot; title=&quot;为你的 App 添加 Peek and Pop&quot;&gt;&lt;/a&gt;为你的 App 添加 Peek and Pop&lt;/h4&gt;&lt;p&gt;为 App 添加 Peek and Pop 非常简单，只要遵循以下几步：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;让需要预览的 ViewController 遵循 &lt;code&gt;UIViewControllerPreviewingDelegate&lt;/code&gt; 协议&lt;/li&gt;
&lt;li&gt;调用 &lt;code&gt;registerForPreviewing(with:sourceView:)&lt;/code&gt; 注册该ViewController&lt;/li&gt;
&lt;li&gt;在 preview 代理方法中提供一个预览的ViewController，&lt;strong&gt;并设置好 context 的 sourceRect&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;在 commit 代理方法中，直接调用 &lt;code&gt;show(_:sender:)&lt;/code&gt; 即可。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;编码的过程中，要注意检查 3D Touch 的可用性。 因为这项功能同定位一样，用户是可以将其关闭的！为了保证所有的用户都能使用到你 App 的功能，应当依据 3D Touch 的可用性，来编写不同的代码。 当 3D Touch 可用时，那就用上着炫酷的新功能吧！如果不支持 3D Touch，我们还有另外一个备选方案 – &lt;code&gt;UILongPressGestureRecognizer&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;另外，不要在 UIViewControllerPreviewingDelegate 中做非常耗时的工作，那会造成界面卡顿。&lt;/p&gt;
&lt;p&gt;合理地利用 Peek and Pop 可以为用户带来无缝的体验。 例如，下一个界面会有大量的初始化工作，在preview的过程中，你可以预先加载并提供部分预览（同时也为下一个界面做准备)，记住不要卡住主线程，等到 Pop 时，界面已经初始化好了。这为用户提供了一个非常好的体验。&lt;/p&gt;
&lt;h4 id=&quot;Preview-Action&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Preview-Action&quot; title=&quot;Preview Action&quot;&gt;&lt;/a&gt;Preview Action&lt;/h4&gt;&lt;p&gt;在 Preview 的过程中，用户可以上滑来唤出类似 Action Sheet 的菜单。实现这一功能只需要重写 ViewController 中的 &lt;code&gt;previewActionItems() -&amp;gt; [UIPreviewActionItem]&lt;/code&gt;方法即可。&lt;br/&gt;系统提供了和 &lt;code&gt;UIAlertAction&lt;/code&gt; 非常类似的 &lt;code&gt;UIPreviewAction&lt;/code&gt;，来实现 &lt;code&gt;UIPreviewActionItem&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;与 Action Sheet 不同的是，系统提供了 &lt;code&gt;UIPreviewActionGroup&lt;/code&gt; 类，实现子菜单的功能。&lt;/p&gt;
&lt;p&gt;在开发 Peek and Pop 的过程中，请记住以下原则&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;让合适的内容支持 Peek and Pop (不要滥用这项特性）&lt;/li&gt;
&lt;li&gt;始终返回相同的预览界面 （保持一致性和可预测性）&lt;/li&gt;
&lt;li&gt;不要在preview代理方法中花太多的时间&lt;/li&gt;
&lt;li&gt;为 context 设置正确的 sourceRect&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;UIPreviewInteractionDelegate&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#UIPreviewInteractionDelegate&quot; title=&quot;UIPreviewInteractionDelegate&quot;&gt;&lt;/a&gt;UIPreviewInteractionDelegate&lt;/h3&gt;&lt;p&gt;iOS 10 中为我们带来了全新的 API，可以让你自定义 Peek and Pop 操作。 我们只需要让某个对象遵循 &lt;code&gt;UIPreviewInteractionDelegate&lt;/code&gt; 协议，并在相对于的代理方法中做我们想做的事情就可以了。 &lt;/p&gt;
&lt;p&gt;UIPreviewInteractionDelegate 一共包含以下四个方法：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// 必须实现
// 这个方法可以让你精细地控制从按压到 Preview 触发过程中发生的事
// 配合 UIViewControllerTransitioningDelegate ，可以做类似新郎微博的 + 号菜单效果。

@available(iOS 10.0, *)
public func previewInteraction(_ previewInteraction: UIPreviewInteraction, didUpdatePreviewTransition transitionProgress: CGFloat, ended: Bool) // transitionProgress ranges from 0 to 1&lt;/code&gt;&lt;/pre&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// 这个方法也是必须实现的，用来处理一些 Interaction 被打断情况
// 比如说：接到一个电话。
@available(iOS 10.0, *)
public func previewInteractionDidCancel(_ previewInteraction: UIPreviewInteraction)&lt;/code&gt;&lt;/pre&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// 你可以用这个方法来控制 Delegate 的触发。
// return false 则不会触发其他代理方法

@available(iOS 10.0, *)
optional public func previewInteractionShouldBegin(_ previewInteraction: UIPreviewInteraction) -&amp;gt; Bool&lt;/code&gt;&lt;/pre&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// 用这个方法来精细地控制 Preview -&amp;gt; Commit 阶段
@available(iOS 10.0, *)
optional public func previewInteraction(_ previewInteraction: UIPreviewInteraction, didUpdateCommitTransition transitionProgress: CGFloat, ended: Bool)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;UIPreviewInteractionDelegate&lt;/code&gt; 让 3D Touch 变得更灵活了。如果我们希望 iOS 9 也支持这样的功能怎么办呢？ 不用担心，Apple 还提供了更底层的 API。&lt;/p&gt;
&lt;h3 id=&quot;Low-Level-Force-API&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Low-Level-Force-API&quot; title=&quot;Low Level Force API&quot;&gt;&lt;/a&gt;Low Level Force API&lt;/h3&gt;&lt;p&gt;在 UITouch 中有两个关键的属性为我们提供了压力相关数据的存储。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;@property(nonatomic,readonly) CGFloat force NS_AVAILABLE_IOS(9_0);
@property(nonatomic,readonly) CGFloat maximumPossibleForce NS_AVAILABLE_IOS(9_0);&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;force&lt;/code&gt; 代表当前 Touch 的压力系数，默认是 0.0 ~ 1.0。你也可以通过 &lt;code&gt;maximumPossibleForce&lt;/code&gt; 来调整 &lt;code&gt;force&lt;/code&gt; 的上限，来为其提供更宽的变化范围。&lt;/p&gt;
&lt;p&gt;上面的 API 仅在支持 3D Touch 和 Apple Pencil 的设备上可用，所以在使用前，不要忘了检查 &lt;code&gt;UITraitCollection&lt;/code&gt; 中的&lt;code&gt;forceTouchCapability&lt;/code&gt;，来确定以上 API 是否可用。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;为什么将 forceTouchCapability 放在 UITraitCollection 中？&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;因为 Size Classes 将设备抽象成了 Size.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id=&quot;3D-Touch-的最佳实践&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#3D-Touch-的最佳实践&quot; title=&quot;3D Touch 的最佳实践&quot;&gt;&lt;/a&gt;3D Touch 的最佳实践&lt;/h3&gt;&lt;ol&gt;
&lt;li&gt;每个 app 都应该提供 quick actions。其简创建简单，却能带来巨大的价值。&lt;/li&gt;
&lt;li&gt;为高价值的任务提供一个快速的入口。&lt;/li&gt;
&lt;li&gt;很重要的一点，你需要保证 quik action 的可预测性，用户们如果经常使用它，却发现每一次的结果都不一样，就会因此而困惑。&lt;/li&gt;
&lt;li&gt;即使你做了 3D touch 用户也可以禁用这一项功能，因此不能过度依赖这项特性来做一些必须的事情,同时也要准备好备选方案。&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;总结&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#总结&quot; title=&quot;总结&quot;&gt;&lt;/a&gt;总结&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;主页的 quick action 可以让你的app 直接进入相关行为。&lt;/li&gt;
&lt;li&gt;Peek and Pop 允许你快速预览内容，并导航到对应界面。&lt;/li&gt;
&lt;li&gt;UIPreviewInteraction 让你可以更精细地控制 3D Touch。&lt;/li&gt;
&lt;li&gt;用户们期望你支持 3D touch。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;参考资料&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#参考资料&quot; title=&quot;参考资料&quot;&gt;&lt;/a&gt;参考资料&lt;/h3&gt;&lt;p&gt;&lt;a href=&quot;https://developer.apple.com/videos/play/wwdc2016/228/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;WWDC 2016 Sssion 228 - A Peek at 3D Touch&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;http://devstreaming.apple.com/videos/wwdc/2016/228a1kbxogojm4fviqc/228/228_a_peek_at_3d_touch.pdf&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;WWDC 2016 Sssion 228 - A Peek at 3D Touch Presentation Slides&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://developer.apple.com/library/prerelease/content/documentation/UserExperience/Conceptual/Adopting3DTouchOniPhone/3DTouchAPIs.html#//apple_ref/doc/uid/TP40016543-CH4-SW1&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Adopting 3D Touch&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://developer.apple.com/library/prerelease/content/samplecode/AppChat/Introduction/Intro.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Apple WWDC 示例代码: AppChat&lt;/a&gt;&lt;/p&gt;</content:encoded></item><item><title>电池电量与低电量模式</title><link>https://www.shengpan.net/blog/battery/</link><guid isPermaLink="true">https://www.shengpan.net/blog/battery/</guid><description>优步最近公布的数据显示， 当电池快没电的时候，人们更愿意接受溢价 。同时，优步也表明他们并没有利用电量相关的数据来设置溢价规则。换句话说，我们在开发App的时候，可以通过电池电量来”提升用户体验”。</description><pubDate>Tue, 31 May 2016 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;优步最近公布的数据显示，&lt;a href=&quot;http://www.npr.org/2016/05/17/478266839/this-is-your-brain-on-uber&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot; title=&quot;UberNews&quot;&gt;当电池快没电的时候，人们更愿意接受溢价&lt;/a&gt;。同时，优步也表明他们并没有利用电量相关的数据来设置溢价规则。换句话说，我们在开发App的时候，可以通过电池电量来”提升用户体验”。&lt;/p&gt;
&lt;h3 id=&quot;电池状态与电量&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#电池状态与电量&quot; title=&quot;电池状态与电量&quot;&gt;&lt;/a&gt;电池状态与电量&lt;/h3&gt;&lt;p&gt;&lt;code&gt;UIDevice&lt;/code&gt; 中有三个电池相关的属性:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;@property(nonatomic,getter=isBatteryMonitoringEnabled) BOOL batteryMonitoringEnabled NS_AVAILABLE_IOS(3_0) __TVOS_PROHIBITED;  // default is NO
@property(nonatomic,readonly) UIDeviceBatteryState          batteryState NS_AVAILABLE_IOS(3_0) __TVOS_PROHIBITED;  // UIDeviceBatteryStateUnknown if monitoring disabled
@property(nonatomic,readonly) float                         batteryLevel NS_AVAILABLE_IOS(3_0) __TVOS_PROHIBITED;  // 0 .. 1.0. -1.0 if UIDeviceBatteryStateUnknown&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;我们可以通过 &lt;code&gt;batteryState&lt;/code&gt; 来获取电池状态，通过 &lt;code&gt;batteryLevel&lt;/code&gt;来获取电池电量信息。&lt;/p&gt;
&lt;p&gt;值得一提的是，在获取电池信息之前，需要手动设置 &lt;code&gt;batteryMonitoringEnabled&lt;/code&gt; 为 &lt;code&gt;YES&lt;/code&gt;，不然&lt;code&gt;batterystate&lt;/code&gt; 会返回 &lt;code&gt;Unkonw&lt;/code&gt;. &lt;/p&gt;
&lt;p&gt;如果想要订阅电池状态，可以注册为以下两个通知的观察者:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;UIKIT_EXTERN NSString *const UIDeviceBatteryStateDidChangeNotification;
UIKIT_EXTERN NSString *const UIDeviceBatteryLevelDidChangeNotification;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;batteryLevel&lt;/code&gt; 的值每改变 0.05（也就是电池电量的 &lt;strong&gt;5%&lt;/strong&gt;）, 就会触发一次 &lt;code&gt;UIDeviceBatteryLevelDidChangeNotification&lt;/code&gt;。&lt;/p&gt;
&lt;h3 id=&quot;低电量模式&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#低电量模式&quot; title=&quot;低电量模式&quot;&gt;&lt;/a&gt;低电量模式&lt;/h3&gt;&lt;p&gt;为了解决续航问题，Apple 在 iOS 9 中为 iPhone 添加了&lt;a href=&quot;https://support.apple.com/en-gb/HT205234&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot; title=&quot;低电量模式&quot;&gt;低电量模式&lt;/a&gt; 。在此模式下，系统会通过禁用一些特性诸如电子邮件自动获取、后台刷新、Hey Siri等，来达到降低能耗的目的。&lt;/p&gt;
&lt;p&gt;低电量模式的设置藏得比较深，以至于从设置中找到它对大多数人来说是一件非常困难的事。换句话说，用户打开了低电量模式，才能真正说明用户所处的情景需要尽可能地节约电量。因此，相比较于直接获取电池电量来说，探测低电量模式是否开启，更能直观地反应产品情景和用户心理。&lt;/p&gt;
&lt;h4 id=&quot;检测低电量模式&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#检测低电量模式&quot; title=&quot;检测低电量模式&quot;&gt;&lt;/a&gt;检测低电量模式&lt;/h4&gt;&lt;p&gt;在 iOS 9 中，我们可以很容易地检测到用户是否开启了低电量模式，&lt;code&gt;NSProcessInfo&lt;/code&gt; 提供了相对于的属性。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;if ([[NSProcessInfo processInfo] isLowPowerModeEnabled]) 
{
  // 做低电量模式下该做的事
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;同时，如果想要对低电量模式的变化做出响应，可以注册为以下通知的观察者：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;NSString * const NSProcessInfoPowerStateDidChangeNotification;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;当我们检测低电量模式的时候，需要注意以下两点:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;低电量模式仅支持 iOS 9 。当 App 需要兼容更早的版本时，先检查api的可用性。&lt;/li&gt;
&lt;li&gt;低电量模式仅适用于 iPhone ,在 iPad 中，&lt;code&gt;isLowPowerModeEnabled&lt;/code&gt; 的返回值始终为 &lt;code&gt;NO&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;当我们检测到用户开启了低电量模式，可以为用户做一些小改变，来帮助用户延长电池续航。以下是 Apple 给出一些建议:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;停止使用定位服务&lt;/li&gt;
&lt;li&gt;减弱动画效果&lt;/li&gt;
&lt;li&gt;停止后台任务（比如网络请求）&lt;/li&gt;
&lt;li&gt;禁用运动追踪&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;参考资料&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#参考资料&quot; title=&quot;参考资料&quot;&gt;&lt;/a&gt;参考资料&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/Performance/Conceptual/EnergyGuide-iOS/index.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Energy Efficiency Guide for iOS Apps&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/videos/play/wwdc2015/707/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;WWDC 2015 Session 707 Achieving All-day Battery Life&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;http://useyourloaf.com/blog/detecting-low-power-mode/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Detecting low power mode&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content:encoded></item><item><title>Objective-C与Swift混编实践</title><link>https://www.shengpan.net/blog/usingswiftwithobjc/</link><guid isPermaLink="true">https://www.shengpan.net/blog/usingswiftwithobjc/</guid><description>由于Swift的语法趋于稳定，目前本人负责的项目也已经在小范围地引入Swift。关于混编过程中遇到的各种思考与选择，胡波的 这篇文章 已经阐述得得比较全面了，看完文章回头看自己在混编过程中的各种选择，与胡先生的看法是一致的。在此梳理一下一些值得注意的</description><pubDate>Tue, 12 Apr 2016 00:00:00 GMT</pubDate><content:encoded>&lt;h3&gt;前言&lt;/h3&gt;
&lt;p&gt;由于Swift的语法趋于稳定，目前本人负责的项目也已经在小范围地引入Swift。关于混编过程中遇到的各种思考与选择，胡波的&lt;a href=&quot;http://mp.weixin.qq.com/s?__biz=MzA3ODg4MDk0Ng==&amp;amp;mid=403474677&amp;amp;idx=1&amp;amp;sn=5163adb2d80aa5b4f0099f79e6d783e1&amp;amp;scene=0#wechat_redirect&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这篇文章&lt;/a&gt;已经阐述得得比较全面了，看完文章回头看自己在混编过程中的各种选择，与胡先生的看法是一致的。在此梳理一下一些值得注意的小细节。&lt;/p&gt;
&lt;h3 id=&quot;Optional&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Optional&quot; title=&quot;Optional&quot;&gt;&lt;/a&gt;Optional&lt;/h3&gt;&lt;p&gt;基于Objective-C的工程一般都是将JSON转为Model,把数据以Model的形式在对象之间传递。当服务器传过来的值为空或者类型错误时，大部分解析框架都会将相对应的值置为nil。我们知道在Objective-C的世界里，向nil发送消息是不会引发任何错误的。&lt;/p&gt;
&lt;p&gt;Objective-C中没有任何问题的属性：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;@property (nonatomic, strong) NSString *GroupName;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;到了Swift的世界里，变成了:&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/04/nullable-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;没错，隐式解析的存在，导致了容错能力的下降。只要服务端回传的参数中有一个空字段，必然引发Crash。这简直是自寻死路。&lt;/p&gt;
&lt;p&gt;因此我们需要在Objective-C中，将属性标上&lt;code&gt;nullable&lt;/code&gt;，这样Swift中该属性变成了optional,然后采用&lt;code&gt;if let&lt;/code&gt;或者&lt;code&gt;guard let&lt;/code&gt;来安全地拆包。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;即使业务上决定了某些字段绝对不可能为null,也仍然要将其设为nullable。校验任何外来输入是编程时的基本准则之一。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;想必大家也想到了，这样一来，在混编的过程中，if let充斥着Swift的代码，虽然保证了安全，但一定程度上降低了开发效率。个人还在不断摸索解决这个问题的方法。&lt;/p&gt;
&lt;h3 id=&quot;Selector&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Selector&quot; title=&quot;Selector&quot;&gt;&lt;/a&gt;Selector&lt;/h3&gt;&lt;p&gt;在Objective-C的世界里，&lt;code&gt;@selector&lt;/code&gt;是我们的老朋友了。但到了Swift中我们不得不这样来用&lt;code&gt;Selector&lt;/code&gt;:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;self.addTarget(self, action: &quot;resignFristResponder&quot;, forControlEvents: .EditingDidEndOnExit)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果不仔细看，一定不会发现上面的代码中我错将&lt;code&gt;resignFirstResponder&lt;/code&gt;写成了&lt;code&gt;resignFristResponder&lt;/code&gt;。这在编译时不会出现任何提醒，但到了运行时会引起崩溃。&lt;/p&gt;
&lt;p&gt;幸运的是，Swift2.2用&lt;code&gt;#selector&lt;/code&gt;关键字替代了字符串反射。此时拼写错误可以被编译期正确地纠正了–因为编译期会检查到方法不存在，并报一个error。&lt;/p&gt;
&lt;p&gt;你可以这样写一个不带参数的selector：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;#selector(resignFirstResponder）&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果是带参数的selector,则会稍微特别一点：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;#selector(textFieldDidChange(_:)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;采用下划线来忽略参数名，但记得保留分号。&lt;/p&gt;
&lt;p&gt;update:2016年06月22日&lt;/p&gt;
&lt;p&gt;在Swift 3中，由于第一个参数也必须指定参数名，因此，selector的语法稍稍有一点点改变：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;#selector(textFieldDidChange(textField:)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;有一点需要注意一下，Selector只支持反射Objective-C的方法，如果想要让#selector能正确识别Swift的方法，需要在方法前面加上&lt;code&gt;@objc&lt;/code&gt;关键字&lt;/p&gt;
&lt;h3 id=&quot;命名&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#命名&quot; title=&quot;命名&quot;&gt;&lt;/a&gt;命名&lt;/h3&gt;&lt;p&gt;Swift得益于Module而避免了类的命名冲突。在用Swift编写代码的时候，应当遵循Apple官方的命名规范。例如类命名不需要在类名前加前缀。如果类也需要在Objective-C中被调用，可以用@objc关键字来为Objective-C生成对应的类名。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;@objc(PSLimitedTextField) public class LimitedTextField: UITextField {&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;同时API的设计也建议按照官方的&lt;a href=&quot;https://swift.org/documentation/api-design-guidelines&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;指导原则&lt;/a&gt;来。我从开始写Objective-C时就尽量模仿Apple的命名方式，后来在Objective-C到Swift的自动桥接上尝到了甜头。比如说:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;- (instancetype)initWithName:(NSString *)name;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;被自动桥接成了&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;init(name: String)&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;工厂方法&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#工厂方法&quot; title=&quot;工厂方法&quot;&gt;&lt;/a&gt;工厂方法&lt;/h4&gt;&lt;p&gt;如果仔细对比Objective-C和Swift的接口，你会发现有的类的工厂方法消失了，有的类的还在。这同样是由于命名的问题所导致的。Apple将那些同类名一致的工厂方法桥接成了init方法，将一些默认单词(default,standard,shared etc.)开头的工厂方法保留了下来。&lt;/p&gt;
&lt;p&gt;如：&lt;code&gt;[NSDate date]&lt;/code&gt;变成了&lt;code&gt;NSDate()&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;但&lt;code&gt;[NSUserDefaults standardUserDefaults]&lt;/code&gt;,保留了下来，变成了&lt;code&gt;NSUserDefaults.standardUserDefaults()&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/DeveloperPans/PSNumberPad&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;PSNumberPad&lt;/a&gt;就因为工厂方法的命名问题，没能自动桥接成Swift的方法。因此，在混编过程中，如果Objective-C的组件有可能被Swift调用的，需要妥善设计接口以便自动桥接。一个最佳实践是，多采用&lt;strong&gt;convince initialzer&lt;/strong&gt;替代工厂方法。&lt;/p&gt;
&lt;h3 id=&quot;参考资料&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#参考资料&quot; title=&quot;参考资料&quot;&gt;&lt;/a&gt;参考资料&lt;/h3&gt;&lt;p&gt;在混编的过程中，大部分问题你可以在&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/Swift/Conceptual/BuildingCocoaApps/index.html#//apple_ref/doc/uid/TP40014216-CH2-ID0&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这里&lt;/a&gt;找到想要的答案。再一次感谢Apple完善的文档！&lt;/p&gt;</content:encoded></item><item><title>Storyboard的爱与恨（下）</title><link>https://www.shengpan.net/blog/storyboard2/</link><guid isPermaLink="true">https://www.shengpan.net/blog/storyboard2/</guid><description>如我们所料，Storyboard也可以通过可视化的操作来实现Scene的转场。</description><pubDate>Mon, 22 Feb 2016 00:00:00 GMT</pubDate><content:encoded>&lt;h3 id=&quot;Scene的转场&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Scene的转场&quot; title=&quot;Scene的转场&quot;&gt;&lt;/a&gt;Scene的转场&lt;/h3&gt;&lt;p&gt;如我们所料，Storyboard也可以通过可视化的操作来实现Scene的转场。&lt;/p&gt;
&lt;p&gt;故事板的转场有两种，可以分为手动触发和自动触发。自动触发完全由Storyboard实现，而手动触发则需要配合代码。前者简单易用，后者适用于配合业务逻辑，进行不同转场的触发。自动触发的转场非常简单，我们只需选择一个UIControl(比如UIButton),按住Control+左键，拖线至目标Scene,选择&lt;code&gt;Action&lt;/code&gt;类型，即可在触发UIControl的某些事件的时候，自动执行转场。&lt;br/&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/ooooo-1.gif&quot;/&gt;&lt;/p&gt;
&lt;p&gt;例如利用UIButton转场，实际上是在触发&lt;code&gt;TouchUpInside&lt;/code&gt;事件时执行。这一简单的操作实际上相当于如下代码:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;- (void)viewDidLoad
{
    [self.button addTarget:self
                    action:@selector(showPSViewControllerB)
          forControlEvents:UIControlEventTouchUpInside];

}

- (void)showPSViewControllerB
{
    PSViewControllerB *viewController = [[PSViewControllerB alloc]init];
    //配置..传值...
    [self.navigationController pushViewController:viewController animated:YES];
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Storyboard将Scene转场变成了可视化的操作又引入了一个新的问题，需要如何传递参数给目标ViewController？&lt;/p&gt;
&lt;p&gt;解决方法就是，我们需要在Storyboard中给Segue一个Identifier，然后在源ViewController中重写如下方法即可:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender
{
    if ([segue.identifier isEqualToString:[PSViewControllerB description]])
    {
        PSViewControllerB *vc = segue.destinationViewController;
        //配置..传值..
    }
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;手动触发则需要代码配合。不同的是，拖线的对象从UIControl变成了UIViewController(不要忘了在Storyboard中填写Segue Identifier)。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/aaa.gif&quot;/&gt;&lt;/p&gt;
&lt;p&gt;然后在代码中需要转场的地方，加上&lt;code&gt;performSegueWithIdentifier:sender:&lt;/code&gt;即可。例子如下：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;//self:PSViewControllerA
    if (isBizSuccess){
        [self performSegueWithIdentifier:[PSViewControllerB description] sender:parameter];
    } else {
        [self showTips:@&quot;some failure reason&quot;];
    }&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;你可以利用&lt;code&gt;performSegueWithIdentifier:sender:&lt;/code&gt;来进行任何形式的转场。Segue为我们的转场提供了不同的Action，囊括了常见的UINavigationViewController的push，或者所有ViewController都可以执行的Modelly Presentation。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;事实上，在iOS 8以后，我们就可以利用Storyboard结合代码实现自定义的转场，无论是在哪一种上下文环境中。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;采用Storyboard进行Scene转场的好处在于，一个ViewController的所有转场代码，都集中到了&lt;code&gt;prepareForSegue:sender:&lt;/code&gt;方法中，debug或者添加新功能时，可以很容易顺藤摸瓜。但缺点同样明显。每次转场的修改/删除需要同时修改Storyboard和代码文件。同时，随着项目的进行，越来越多的Scene和业务逻辑，导致Storyboard中Segue的数量剧增，难以维护。&lt;/p&gt;
&lt;p&gt;&lt;em&gt;巨量的Segue(仅仅是部分截图)&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;难以维护的Segue&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-22-17-04-05.png&quot;/&gt;&lt;/p&gt;
&lt;h4 id=&quot;多Storyboard协作&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#多Storyboard协作&quot; title=&quot;多Storyboard协作&quot;&gt;&lt;/a&gt;多Storyboard协作&lt;/h4&gt;&lt;p&gt;解决如上问题的方法就是，尽量将项目的界面分割在多个Storyboard文件中。一个最佳实践是，按照项目功能模块来区分故事板，例如&lt;code&gt;Login.Storyboard&lt;/code&gt;,&lt;code&gt;Chat.Storyboard&lt;/code&gt;,&lt;code&gt;Person.Storyboard&lt;/code&gt;等。尽量把每个Storyboard的Scene数量控制在20个以内。&lt;/p&gt;
&lt;p&gt;同时，Scene间的转场我们依然可以采用Segue,并且使用起来和单个Storyboard无异。这要多亏Apple在iOS 9新推出的&lt;br/&gt;&lt;a href=&quot;/blog/top-tips-for-ios9/&quot;&gt;UIStoryboard Reference&lt;/a&gt;。&lt;/p&gt;
&lt;h3 id=&quot;代码可视化&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#代码可视化&quot; title=&quot;代码可视化&quot;&gt;&lt;/a&gt;代码可视化&lt;/h3&gt;&lt;p&gt;还有什么能比代码可视化更加炫酷的呢？作为前端工程师，最享受的时候，就是枯燥的代码和算法变成了优美的动画。但这一切都只在按下command+R之后。&lt;/p&gt;
&lt;p&gt;现在，通过Storyboard,我们也可以在编译时实时预览我们的代码所产生的效果。&lt;/p&gt;
&lt;h4 id=&quot;IB-DESIGNABLE&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#IB-DESIGNABLE&quot; title=&quot;IB_DESIGNABLE&quot;&gt;&lt;/a&gt;IB_DESIGNABLE&lt;/h4&gt;&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/IB_DESIGNABLE.gif&quot;/&gt;&lt;/p&gt;
&lt;p&gt;通过为自定义的View添加&lt;code&gt;IB_DESIGNABLE&lt;/code&gt;关键字（注意图中关键字的位置）,我们让Storyboard为我们自定义的视图进行实时渲染。有的人可能会担心实时渲染造成的性能问题。这点大可放心，Xcode有一套非常优秀的缓存机制(优秀到有些时候必须要clean一下，某些小改动才会在真机上生效),只需要编译一次，视图就会被缓存，不会造成每次在Storyboard、代码文件中切换时多次渲染的问题。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;在swift中则为@IBDesignable，放在class关键字之前&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;到这里令人惊叹的类似Playground的事实渲染功能，已经可以动态地应用在项目中了。我们可以利用IB_DESIGNABLE和IBInspectable来制作图表等高度自定义的、独特的视图。&lt;/p&gt;
&lt;p&gt;当然，故事板狂魔对故事板的使用不会就此罢手的，本着一切能用Storyboard配置就不写代码的原则，我们也希望可以在故事板中配置自定义控件的属性。幸运的是，Apple再次为我们的想法提供了可能。&lt;/p&gt;
&lt;h4 id=&quot;IBInspectable&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#IBInspectable&quot; title=&quot;IBInspectable&quot;&gt;&lt;/a&gt;IBInspectable&lt;/h4&gt;&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/IBInspectable.gif&quot;/&gt;&lt;/p&gt;
&lt;p&gt;通过为自定义View的属性添加&lt;code&gt;IBInspectable&lt;/code&gt;关键字（注意图中关键字的位置），我们可以将原本需要代码配置的属性，放到故事板中。IBInspectable支持以下类型的属性：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;BOOL &lt;/li&gt;
&lt;li&gt; NSString&lt;/li&gt;
&lt;li&gt;NSNumber &lt;/li&gt;
&lt;li&gt;CGPoint&lt;/li&gt;
&lt;li&gt;CGSize&lt;/li&gt;
&lt;li&gt;CGRect&lt;/li&gt;
&lt;li&gt;UIColor&lt;/li&gt;
&lt;li&gt;NSRange&lt;/li&gt;
&lt;li&gt;UIImage&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;在swift中则为@IBInspectable，放在var关键字之前&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h4 id=&quot;为系统控件添加IBInspectable&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#为系统控件添加IBInspectable&quot; title=&quot;为系统控件添加IBInspectable&quot;&gt;&lt;/a&gt;为系统控件添加IBInspectable&lt;/h4&gt;&lt;p&gt;不少设计设都喜欢设计圆角。通常我们需要写如下代码:&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;view.layer.cornerRadius = 5;
view.layer.masksToBounds = YES;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;为了解决这些重复代码的问题，有的人喜欢为View写Category，一行代码实现圆角。然而这需要在不同的ViewController中不断引入这个Category,不够优雅。当然，这种小事情我们也肯定不会愿意采用继承的。&lt;/p&gt;
&lt;p&gt;实际上，我们只需要为项目添加一个View的Category，在其中声明一个@property并加上IBInspectable关键字,然后在实现文件中的getter&amp;amp;&amp;amp;setter方法中实现具体的逻辑。&lt;strong&gt;不用import头文件，也不需要运行&lt;/strong&gt;,Storyboard中将自动出现这个属性以供配置。这不正是我们梦寐以求的完全解耦吗！？&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;//UIView+CornerRadius.h
@interface UIView (CornerRadius)

@property (nonatomic, assign) IBInspectable CGFloat cornerRadius;

@end&lt;/code&gt;&lt;/pre&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;//UIView+CornerRadius.m
@implementation UIView (CornerRadius)

- (void)setCornerRadius:(CGFloat)cornerRadius
{
    self.layer.cornerRadius = cornerRadius;
    self.layer.masksToBounds = cornerRadius &amp;gt; 0;
}

- (CGFloat)cornerRadius
{
    return self.layer.cornerRadius;
}
@end&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/CornerRadius.gif&quot;/&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;实际上，IBInspectable是对运行时属性进行的一种拓展，你在Attributed Inspector中进行的自定义属性配置，都会在Identity Inspector的运行时属性中得到体现。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id=&quot;Storyboard的弊端&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Storyboard的弊端&quot; title=&quot;Storyboard的弊端&quot;&gt;&lt;/a&gt;Storyboard的弊端&lt;/h3&gt;&lt;p&gt;Storyboard也并非十全十美的。它依然有许多的问题亟待解决，有些致命的问题，更是成为导致许多开发者放弃Storyboard的原因。在iOS9普及率已经达到&lt;a href=&quot;https://developer.apple.com/support/app-store/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;77%&lt;/a&gt;的今天，Storyboard仍然有很多问题需要完善。&lt;/p&gt;
&lt;h4 id=&quot;难以维护&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#难以维护&quot; title=&quot;难以维护&quot;&gt;&lt;/a&gt;难以维护&lt;/h4&gt;&lt;p&gt;Storyboard在某些角度上，是难以维护的。我所遇到过的实际情况是，公司一个项目的2.0版本，设计师希望替换原有字体。然而原来项目的每一个Label都是采用Storyboard来定义字体的，因此替换新字体需要在Storyboard中更改每一个Label。&lt;/p&gt;
&lt;p&gt;幸亏我们知道Storyboard的源文件是XML，最终写了一个读取-解析-替换脚本来搞定这件事。&lt;/p&gt;
&lt;h4 id=&quot;性能瓶颈&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#性能瓶颈&quot; title=&quot;性能瓶颈&quot;&gt;&lt;/a&gt;性能瓶颈&lt;/h4&gt;&lt;p&gt;当项目达到一定的规模，即使是高性能的MacBook Pro,在打开Storyboard是也会有3-5秒的读取时间。无论是只有几个Scene的小东西，还是几十个Scene的庞然大物，都无法避免。Scene越多的文件，打开速度越慢(从另一个方面说明了分割大故事板的重要性)。&lt;/p&gt;
&lt;p&gt;让人沮丧的是，这个造成卡顿的项目规模并不是太难达到。&lt;/p&gt;
&lt;p&gt;我猜想是由于每一次打开都需要进行I/O操作造成的，Apple对这一块的缓存优化没有做到位。可能是由于Storyboard占用了太多内存，难以在内存中进行缓存。Whatever,这个问题总是让人困扰的。&lt;/p&gt;
&lt;p&gt;然而需要指出的是，采用Storyboard开发或采用纯代码开发的App，在真机的运行效率上，并没有太大的区别。&lt;/p&gt;
&lt;h4 id=&quot;错误定位困难&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#错误定位困难&quot; title=&quot;错误定位困难&quot;&gt;&lt;/a&gt;错误定位困难&lt;/h4&gt;&lt;p&gt;Storyboard的初学者应该对此深有体会。排除BAD_EXCUSE错误不说，单单是有提示的错误，就足以让人在代码和Storyboard之间来回摸索，却无法找到解决方案。&lt;/p&gt;
&lt;p&gt;一个典型的例子是，在代码中删除了IBOUTLET属性或者IBAction方法，但是却忘了在Storyboard中删除对应的连接，运行后crash。然而控制台只会输出一些模糊其词的错误描述。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;*** Terminating app due to uncaught exception &apos;NSUnknownKeyException&apos;, 
reason: &apos;[&amp;lt;DrawViewController 0x7fe9f6a11240&amp;gt; setValue:forUndefinedKey:]: 
this class is not key value coding-compliant for the key drawButton.&apos;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;有经验的开发者可以从drawButton这个关键字中找到突破口，但大部分刚接触Storyboard的开发者，会被困在其中。&lt;/p&gt;
&lt;h3 id=&quot;最后&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#最后&quot; title=&quot;最后&quot;&gt;&lt;/a&gt;最后&lt;/h3&gt;&lt;p&gt;综合其利弊，毅然选择了站在Storyboard这边。一方面是其提供的便利，另一方面是Apple对Storyboard的大力支持。这一点宏观上看，可以在以往对Storyboard的改进和增强上看出，微观上看，几乎所有iOS 8之后的simple code都或多或少采用了Storyboard作为界面开发工具。有理由相信，Storyboard的未来是光明的。&lt;/p&gt;
&lt;p&gt;愿大家在Storyboard的路(keng)上，越走越远。&lt;/p&gt;</content:encoded></item><item><title>Storyboard的爱与恨（上）</title><link>https://www.shengpan.net/blog/storyboard/</link><guid isPermaLink="true">https://www.shengpan.net/blog/storyboard/</guid><description>尽管现在已经是Apple将Storyboard整合进Xcode中的第四个年头，大家对于Storyboard的评价仍然褒贬不一。 有早期就选择转向Storyboard 用于UI开发的国内业界领头人物，也有 创建项目就立马删除Storyboard 的大牛</description><pubDate>Tue, 02 Feb 2016 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;尽管现在已经是Apple将Storyboard整合进Xcode中的第四个年头，大家对于Storyboard的评价仍然褒贬不一。&lt;a href=&quot;http://onevcat.com/2013/12/code-vs-xib-vs-storyboard/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;有早期就选择转向Storyboard&lt;/a&gt;用于UI开发的国内业界领头人物，也有&lt;a href=&quot;http://martinnormark.com/the-story-of-no-storyboard-in-ios-development/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;创建项目就立马删除Storyboard&lt;/a&gt;的大牛。我经历过纯代码布局，同时也在多个多人合作项目中使用Storyboard开发界面。在初期绕过各种坑后，Storyboard将会是快速构建UI界面的好帮手，特别是在现如今设备分辨率与尺寸日益增加的情况下，它可以帮助工程师们节约大量的界面代码书写时间。Storyboard存在的一大意义在于为UI提供了可视化开发方式，另一方面提供了一种更好的MVC的View层实现方式，让你的ViewController代码更简洁。当然，Storyboard的不足仍然不可忽视，错误的难以定位经常让刚上手的开发者们手足无措，相比于代码更不容易阅读的XML源文件所导致多人合作中的冲突不易解决等问题仍然有待完善。本文从各个方面介绍一下Storyboard，分享一下Storyboard的一些使用心得。&lt;/p&gt;
&lt;h3 id=&quot;历史&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#历史&quot; title=&quot;历史&quot;&gt;&lt;/a&gt;历史&lt;/h3&gt;&lt;p&gt;1986年Jean-Marie Hullot发明了IB(Interface Build–Storyboard的前身),并且和Macintosh的工具箱无缝融合，这一工具被Denison Bollay发现了。第二年， Denison Bollay带着Hullot和他的IB到NeXT,将IB演示给Steve Jobs看。老乔立意识到了IB的价值，并将其纳入到了NeXTSTEP中。之后Steve 带着NeXT的技术结晶(当然也包括IB)重新回归Apple，并将之整合到了Apple的体系中。2008年第一代iPhone SDK发布的时候，IB就已经捆绑在其中。到了Xcode4,Apple更是直接将其集成进IDE里。随后随着不断地改进，更新，演变，最终变成了我们今天所看到的Storyboard。从某种角度来说，Storyboard也是老乔留给我们的众多礼物之一。&lt;/p&gt;
&lt;h3 id=&quot;故事板能做什么&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#故事板能做什么&quot; title=&quot;故事板能做什么&quot;&gt;&lt;/a&gt;故事板能做什么&lt;/h3&gt;&lt;p&gt;故事板主要为我们提供了以下的功能：(这些功能都是&lt;strong&gt;可视化&lt;/strong&gt;的)&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Auto Layout&lt;/li&gt;
&lt;li&gt;Size Classes&lt;/li&gt;
&lt;li&gt;Secnce的跳转 &lt;/li&gt;
&lt;li&gt;代码可视化&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;Auto-Layout&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Auto-Layout&quot; title=&quot;Auto Layout&quot;&gt;&lt;/a&gt;Auto Layout&lt;/h4&gt;&lt;p&gt;自动布局颠覆了之前直接操作Frame的布局方式，从思考&lt;strong&gt;View应该在哪个位置&lt;/strong&gt;,变成了考虑&lt;strong&gt;在特定条件下，View的所处的位置需要满足哪些条件&lt;/strong&gt;。通过这些条件来确定View的Frame。自动布局在实际应用中大体上可以将分为三组:&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;View与Super View的约束&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-15-27-33.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;View自身的约束&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-15-27-47-2.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;View与Other View的约束&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-15-27-58-2-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;假如我们需要在代码中使用自动布局可以使用&lt;br/&gt;&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/AutolayoutPG/VisualFormatLanguage.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Visual Format Language&lt;/a&gt;或者&lt;code&gt;NSLayoutConstraint&lt;/code&gt;的简单工厂方法来生成约束，然后添加到View上。我们来看一个例子：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;//用代码来实现上图中View与Super View的约束
    UIView *superView = self.view;
    UIView *subView = [[UIView alloc] init];
    NSLayoutConstraint *leadingConstraint = [NSLayoutConstraint constraintWithItem:superView
                                                           attribute:NSLayoutAttributeLeading
                                                           relatedBy:NSLayoutRelationEqual
                                                              toItem:subView
                                                           attribute:NSLayoutAttributeLeading
                                                          multiplier:1
                                                            constant:15];
    NSLayoutConstraint *TrailingConstraint = [NSLayoutConstraint constraintWithItem:superView
                                                                         attribute:NSLayoutAttributeTrailing
                                                                         relatedBy:NSLayoutRelationEqual
                                                                            toItem:subView
                                                                         attribute:NSLayoutAttributeTrailing
                                                                        multiplier:1
                                                                          constant:15];

//topConstraint init...
//bottomConstraint init...
    [superView addConstraint:leadingConstraint];
    [superView addConstraint:TrailingConstraint];
    [superView addConstraint:topConstraint];
    [superView addConstraint:bottomConstraint];
    
    // 如果是iOS8+ 则使用下面的方式来激活Constraint
    // leadingConstraint.active = YES;
    // leadingConstraint.active = YES;
    // leadingConstraint.active = YES;
    // leadingConstraint.active = YES;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;是不是一大团乱糟糟的代码?Visual Format Language用起来更加令人崩溃。好在业界已经有比较好的代码自动布局的&lt;a href=&quot;https://github.com/SnapKit/Masonry&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;第三方解决方案&lt;/a&gt;。但是仍然会有大堆的简单界面布局代码残留在你的代码中。&lt;/p&gt;
&lt;p&gt;为了让你的生活更轻松(也为了让代码更清爽)，Storyboard就包含了非常优雅的可视化自动布局解决方案。以上一切，在Storyboard中都被浓缩成了两个按钮（下图红圈中的椭圆按钮）。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/1111.png&quot;/&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;红框1:为被选中View和离他最近的View(可能是SuperView,也可能是另一个同层级的View,看哪个离它更近)添加Leading、Training、Top、Bottom四个属性约束。&lt;/li&gt;
&lt;li&gt;红框2:为View添加自身宽和高约束&lt;/li&gt;
&lt;li&gt;红色椭圆左侧按钮:当选中多个View时，为多个View添加约束&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;只需要点击几下鼠标，Storyboard就可以帮你轻松完成视图布局。&lt;/p&gt;
&lt;h4 id=&quot;Auto-Layout-Debug&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Auto-Layout-Debug&quot; title=&quot;Auto Layout Debug&quot;&gt;&lt;/a&gt;Auto Layout Debug&lt;/h4&gt;&lt;p&gt;使用代码来对Auto Layout布局的另一个缺点在于debug的困难。当添加了多余的约束，往往只能在运行时才能发现错误。同时，要寻找出是哪一行代码添加了错误的约束也比较费力(往往连控制台都没有错误输出)。&lt;/p&gt;
&lt;p&gt;而Storyboard却为此提供了非常友好的静态检查。主要针对View的约束、布局提供警告和Error,甚至是解决方案。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-16-30-51.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;上图的例子是：我们为Label添加了多余的约束，Storyboard用红色标记出冲突的约束，并给出修改建议:&lt;em&gt;删除其中一个约束以保证约束的正确性。&lt;/em&gt;是不是很友好？ ：）&lt;/p&gt;
&lt;h4 id=&quot;Size-Classes&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#Size-Classes&quot; title=&quot;Size Classes&quot;&gt;&lt;/a&gt;Size Classes&lt;/h4&gt;&lt;p&gt;Apple 与iOS 8推出了Size Classes的概念。意在解决因设备尺寸造成的适配问题。Size Classes通过将界面的宽度和高度抽象为&lt;code&gt;正常&lt;/code&gt;和&lt;code&gt;紧凑&lt;/code&gt;两种概念，通过合理的组合，可以将现有设备(以及未来将要出现的设备)划分到不同的Size中。因此，无论是代码还是界面布局，只需要针对Size进行，而不用再拘泥于分辨是iPhone还是iPad,是横屏还是竖屏的问题了。Size Classes的推出是具有前瞻性的，无论是Apple Watch还是iOS 9推出的的iPad 分屏模式，都可以用Size Classes完美解决适配的问题。&lt;/p&gt;
&lt;p&gt;Size Classes和现有设备的对照表如下：&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-16-50-33.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;在之前，我们要对横屏竖屏的界面进行区分，代码一般是这样的：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;if (IPAD_PORTRAIT)
{
    //TODO:modify something portrait
}
else
{
    //TODO:modify something landscape
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在Size Classes时代，Apple引入了一个新的类&lt;code&gt;UITraitCollection&lt;/code&gt;来封装水平和垂直方向的Size信息。现在我们通过代码来改变界面是这样的：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;- (void)willTransitionToTraitCollection:(UITraitCollection *)newCollection 
              withTransitionCoordinator:(id &amp;lt;UIViewControllerTransitionCoordinator&amp;gt;)coordinator
{
    [super willTransitionToTraitCollection:newCollection 
                 withTransitionCoordinator:coordinator];
    [coordinator animateAlongsideTransition:^(id &amp;lt;UIViewControllerTransitionCoordinatorContext&amp;gt; context) 
    {
        if (newCollection.verticalSizeClass == UIUserInterfaceSizeClassCompact) {
            //To Do: modify something for compact vertical size
        } else {
            //To Do: modify something for other vertical size
        }
        [self.view setNeedsLayout];
    } completion:nil];
}&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在TODO中做相对应Size的事。&lt;/p&gt;
&lt;p&gt;可以想见的是，仍然会有非常多的布局代码占据着你的源文件。但在Storyboard中，一切变得异常简单。&lt;/p&gt;
&lt;p&gt;使用Size Classes，我们只需要选择相对应的size，在那个Size下进行布局。运行时，就会根据设备的尺寸，自动地展示相对应Size的布局。比如iPhone竖屏就展示&lt;code&gt;width Compact height Regular&lt;/code&gt;Size下的信息。当手机横屏，系统会自动添加一个过渡动画(虽然有点生硬),并转到&lt;code&gt;width Regular height Compact&lt;/code&gt;的Size。这一切不需要一行代码。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;能不能再给力点?&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Sure.有这么一种情景:&lt;em&gt;iPhone横屏下，拥有一个&lt;code&gt;avatarView&lt;/code&gt;,竖屏下拥有一个相同的&lt;code&gt;avatar View&lt;/code&gt;&lt;/em&gt;。这种情况下我们只需要在一个Size中完成这个View,然后在Storyboard的&lt;code&gt;attributed inspector&lt;/code&gt;中做一些勾选，将其”install”进相对应的Size中，就可以达到复用的目的。如果有差异，则在对应的Size中定制即可。（如下图）&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-17-07-12-1.png&quot;/&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;能不能再给力点儿？&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Of Course！除了View,约束也可以不同Size配置不同。最厉害的是，图片文件也可以根据Size来区分。我们只需要对&lt;code&gt;.xcassets&lt;/code&gt;文件勾选Size Classes,就可以为不同Size配置不同图片.这意味着，在同一个安装包下，通过Size Classes，我们甚至可以为横屏iPhone和竖屏iPhone做出完全不同的App!&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/02/-----2016-02-19-17-29-01.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;/storyboard2&quot;&gt;Storyboard的爱与恨(下)&lt;/a&gt;&lt;/p&gt;</content:encoded></item><item><title>App Store审核指南-中文版</title><link>https://www.shengpan.net/blog/app-store-review-guidelines/</link><guid isPermaLink="true">https://www.shengpan.net/blog/app-store-review-guidelines/</guid><description>本文原文来自 Cocoachina .本文对其整理归纳，重点标注出开发者们不熟悉且容易触碰的雷区，并做了页内跳转的制作和格式的美化，以方便阅读和查询。</description><pubDate>Sun, 24 Jan 2016 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;出处&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#出处&quot; title=&quot;出处&quot;&gt;&lt;/a&gt;出处&lt;/h2&gt;&lt;p&gt;本文原文来自&lt;a href=&quot;http://www.cocoachina.com/appstore/20160125/15089.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Cocoachina&lt;/a&gt;.本文对其整理归纳，重点标注出开发者们不熟悉且容易触碰的雷区，并做了页内跳转的制作和格式的美化，以方便阅读和查询。&lt;/p&gt;
&lt;p&gt;英文版文档原文为&lt;a href=&quot;https://developer.apple.com/app-store/review/guidelines/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;App Store Review Guidelines&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&quot;前言&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#前言&quot; title=&quot;前言&quot;&gt;&lt;/a&gt;前言&lt;/h2&gt;&lt;p&gt;感谢您付出宝贵的才华与时间来开发iOS应用程程序。从职业与报酬的角度而言，这对于成千上万的开发员来说一直都是一项值得投入的事业，我们希望帮助您加入这个成功的组织。我们发布了《App Store审核指南》（App Store Review Guidelines），希望通过它帮您避开开发应用程序过程中的一些问题，并帮你在提交应用时加快审核流程。&lt;/p&gt;
&lt;p&gt;我们将应用程序（Apps）视为与书籍或歌曲不同的产品，我们并不存储它们。如果您意欲批评宗教，那就去写本书。如果您想要描述性，那就写本书或写首歌，或者可以创建一个医疗程序。这么做可能会比较复杂，但是我们不允许在应用程序商店（App Store）出现某种禁止内容。这会让您认识到我们秉持的更为深远的目的：&lt;/p&gt;
&lt;p&gt;我们有很多可供儿童可以下载的应用程序。家长的监护可以很好地保护孩子，但是您需要做您应该做的那一部分。因此，您要了解我们时刻在留心着您的孩子。&lt;/p&gt;
&lt;p&gt;App Store中有数百万的应用。如果您的应用程序没有什么有益的用途，不是独一无二的或者不能提供持续性的娱乐功能，那它可能不会被我方接受。&lt;/p&gt;
&lt;p&gt;如果您的应用程序看上去像是那种只花了几天功夫简单拼凑出来的产品，或者只是想在我们的商店中抓住朋友的眼球，请提前做好被拒的准备。我们有很多态度严谨的开发者，不希望他们的高品质应用程序充斥在一些业余作品之中。&lt;/p&gt;
&lt;p&gt;我们将拒绝任何包含越界内容或行为的应用程序。您可能会问道，具体限制是什么？最高法院的法官曾有言：”它出现时我自然心中有数。”当您越过这一范围时，我们认为您也会有自知之明。&lt;/p&gt;
&lt;p&gt;如果您的应用程序被拒，我们设立了一个审查委员会供您上诉。如果您去媒体抨击我们，肯定对您于事无补。&lt;/p&gt;
&lt;p&gt;如果您试着作弊（比如在审核流程中作假，窃取用户数据，抄袭其他开发者作品，或者操作应用评分），我们将会移除您的应用程序，并且将您从开发者计划中除名。&lt;/p&gt;
&lt;p&gt;这是一个动态文档，新提交的应用程序会导致新的问题产生，并可能随时产生新的规则。或许您的应用程序会触及到这一点。 &lt;/p&gt;
&lt;p&gt;最后要说明的是，我们非常珍惜这个平台，并且向您的作品表示敬意。我们确实在尝试尽力创建全球最佳平台，以便让您展示才华，同时获得相应的报酬。如果这读上去让您感觉我们的控制欲过强，那是因为我们曾向用户承诺保证，我们将利用我们的产品让他们获得高品质体验。&lt;/p&gt;
&lt;p&gt;目录&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href=&quot;#1&quot;&gt;条款与条件&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#2&quot;&gt;功能&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#3&quot;&gt;元数据&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#4&quot;&gt;位置&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#5&quot;&gt;推送通知&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#6&quot;&gt;游戏中心&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#7&quot;&gt;广告&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#8&quot;&gt;内容和知识产权&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#9&quot;&gt;媒体内容&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#10&quot;&gt;用户界面&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#11&quot;&gt;购买与货币&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#12&quot;&gt;抓取与聚合&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#13&quot;&gt;设备损害&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#14&quot;&gt;人身攻击&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#15&quot;&gt;暴力&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#16&quot;&gt;令人反感的内容&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#17&quot;&gt;隐私&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#18&quot;&gt;色情&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#19&quot;&gt;宗教、文化与种族&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#20&quot;&gt;竞赛、赌博、彩票和抽奖&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#21&quot;&gt;慈善与援助&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#22&quot;&gt;法律要件&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#23&quot;&gt;Wallet&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#24&quot;&gt;儿童类别&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#25&quot;&gt;扩展&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#26&quot;&gt;HomeKit&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#27&quot;&gt;HealthKit&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#28&quot;&gt;TestFlight&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#29&quot;&gt;Apple Pay&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;1&quot;&gt;1. 条款和条件&lt;/h3&gt;&lt;br/&gt;1.1 为App Store开发程序，开发者必须遵守&lt;a href=&quot;https://idmsa.apple.com/IDMSWebAuth/login?&amp;amp;appIdKey=891bd3417a7776362562d2197f89480a8547b108fd934911bcbea0110d07f757&amp;amp;path=%2F%2Fmembercenter%2Findex.action#agreements&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Program License Agreement(PLA)&lt;/a&gt;、&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/UserExperience/conceptual/mobilehig/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;人机交互指南（HIG）&lt;/a&gt;以及开发者和苹果签订的任何其他协议和合同。以下规则和例证旨在帮助开发者的程序能获得App Store的认可，而不是修改或删除任何其他协议中的条款。&lt;br/&gt;&lt;br/&gt;&lt;h3 id=&quot;2&quot;&gt;2. 功能&lt;/h3&gt;
&lt;p&gt;2.1 崩溃的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.2 存在错误的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.3 跟开发者宣传不符的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.4 无应用文档或隐藏功能与描述不符的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.5 使用非公开API的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;==2.6 在指定容器范围外读写数据的程序将会被拒绝。==&lt;/p&gt;
&lt;p&gt;2.7 以任何方式或形式下载代码的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.8 安装或运行其他可执行代码的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.9 Demo版、trial版和test版的程序将会被拒绝。 Beta版应用程序仅能通过TestFlight提交，并且必须遵守相关指南。&lt;/p&gt;
&lt;p&gt;==2.10 iPhone程序必须不经修改就能以iPhone分辨率和2倍 iPhone 3GS的分辨率在iPad上运行。==&lt;/p&gt;
&lt;p&gt;2.11 与App Store已有程序重复的应用可能会被拒绝，特别是数量很多的情况下，比如手电筒应用和爱经应用。&lt;/p&gt;
&lt;p&gt;2.12 没有显著用途、不独特的应用程序或者与网站简单捆绑的应用有可能被拒；不提供任何持久娱乐价值的程序可能会被拒绝。&lt;/p&gt;
&lt;p&gt;2.13 内容主要是营销材料或广告的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.14 包含欺骗或虚假功能，却有没有标明的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.15 大于100MB无法通过蜂窝网络下载的应用（App Store会自动禁止）。&lt;/p&gt;
&lt;p&gt;2.16 多任务程序使用后台服务仅限于几种目的：VoIP、音频播放、地理位置、完成任务以及本地提醒等。&lt;/p&gt;
&lt;p&gt;==2.17 应用程序只允许使用iOS WebKit框架和WebKit Javascript浏览web内容。==&lt;/p&gt;
&lt;p&gt;2.18 鼓励酗酒或使用违禁药物，或引诱青少年饮酒或吸烟的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.19 提供错误的系统诊断或不精确的设备数据的应用将会被拒绝。&lt;/p&gt;
&lt;p&gt;==2.20 向App Store上传大量相似版本程序的开发者将会从iOS开发者计划中除名。==&lt;/p&gt;
&lt;p&gt;2.21 简单一首歌曲或者一部影片应用要提交到iTunes store，书籍类应用应该提交到iBookstore。&lt;/p&gt;
&lt;p&gt;==2.22 武断地根据环境（如定位或者运营商）限制用户使用的应用会被拒。==&lt;/p&gt;
&lt;p&gt;2.23 应用必须遵守iOS数据储存指导方针&lt;a href=&quot;https://developer.apple.com/icloud/documentation/data-storage/index.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;（iOS Data Storage Guidelines）&lt;/a&gt;，否则应用将被拒。&lt;/p&gt;
&lt;p&gt;2.24 存放在Newsstand的应用必须遵守开发者项目许可协议&lt;a href=&quot;https://developer.apple.com/membercenter/index.action#agreements&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;（Program License Agreement）&lt;/a&gt;的表1、表2以及表3，否则应用将会被拒。&lt;/p&gt;
&lt;p&gt;==2.25 使用户将其与App Store混淆，或者基于购买或者促销的目的而展示其他应用的应用将会被拒绝==&lt;/p&gt;
&lt;p&gt;2.26 只有当app是出于特殊审核需要（比如健康管理、航空以及无障碍需求等）或为特殊群体用户提供具有重大意义的附加值时，才可以展示和推荐自身以外的其他应用程序，否则应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;2.27 如果App的核心功能不能使用Siri遥控器，那么App将会被拒绝。不过应用程序可以提供与游戏控制器或者其他周边设备相连接的增强功能。（2015.10 新增）&lt;/p&gt;
&lt;h3 id=&quot;3&quot;&gt;3. 元数据（名称、描述、评级、排名等）&lt;/h3&gt;
&lt;p&gt;==3.1 应用或者元数据中提到其他任何移动平台将会被拒。==&lt;br/&gt;案例：AppStore上架描述中提到”Android同步上架”。&lt;/p&gt;
&lt;p&gt;3.2 带有占位符文本的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;3.3 应用程序的名称、描述、截图或者预览与应用的内容和功能不相关将会被拒绝。（旧版：3.3 描述中有与程序内容和功能不相关的信息的应用将会被拒绝。）&lt;/p&gt;
&lt;p&gt;==3.4 为了不混淆用户，iTunes Connect中的应用名称应该和展示在设备上的应用名称一致。==&lt;/p&gt;
&lt;p&gt;3.5 不同尺寸的app icon要一致，否则会造成混淆。&lt;/p&gt;
&lt;p&gt;3.6 应用程序的icon、截图、预览以及位于Apple TV主屏幕顶部展区的Apple TV app的图片展示不符合4+年龄评级的程序将会被拒绝。 （2015.10 修正）&lt;/p&gt;
&lt;p&gt;（旧版：应用程序的icon、截图以及预览不符合4+年龄评级的程序将会被拒绝。）&lt;/p&gt;
&lt;p&gt;3.7 目录与类型不适合于程序内容的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;3.8 开发者有责任为其程序指定适合的评级。不相称的评级可能会由苹果公司修改。&lt;/p&gt;
&lt;p&gt;3.9 开发者有责任为其程序指定恰当的关键字。不恰当的关键词可能会被苹果公司修改/删除。&lt;/p&gt;
&lt;p&gt;3.10试图通过伪造评论或者付费评论的方式在AppStore中操纵或者其欺骗用户评论（或者采用其他不正当方式）以提升排名的开发者将会被苹果从iOS开发者计划中除名。&lt;/p&gt;
&lt;p&gt;3.11 在安装或打开应用之前，推荐用户重启iOS设备的应用将会被拒。&lt;/p&gt;
&lt;p&gt;3.12 提交审核的应用程序应包含能正常运行的URL，比如支持服务URL和隐私政策URL。&lt;/p&gt;
&lt;p&gt;3.13 应用程序的截图、预览或者营销文本没有清晰地指出附加内容或项目需要额外单独购买（比如使用IAP）将会被拒绝。&lt;/p&gt;
&lt;p&gt;3.14 App预览仅能使用从应用程序捕获的视频屏幕、旁白、文本以及design overlays，否则应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;==3.15 添加App预览的应用程序，未经许可展示真人个人信息将会被拒绝。==&lt;/p&gt;
&lt;p&gt;3.16 App预览仅能使用在所有选定地区内经过授权许可、用于此目的的音乐。&lt;/p&gt;
&lt;p&gt;3.17 App预览和截图包含未经授权的通过App（如音乐、视频以及以及相关封面艺术设计）播放的内容或流媒体将会被拒绝。（2015.10 修正）&lt;/p&gt;
&lt;p&gt;（旧版：App预览包含未经授权的通过app播放的内容（比如iTunes playlist和YouTube流媒体）的应用将会被拒绝。）&lt;/p&gt;
&lt;h3 id=&quot;4&quot;&gt;4. 位置&lt;/h3&gt;
&lt;p&gt;4.1 在收集、传输或使用位置数据之前未通知并获得用户同意的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;4.2 将基于位置的API用于车辆、飞机或其他设备的自动控制或自主控制的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;4.3 将基于位置的API用于应急服务的应用程序将会被拒绝。（旧版：4.3 将基于位置的API用于调度、车队管理或应急服务的程序将会被拒绝。）&lt;/p&gt;
&lt;p&gt;4.4 当与提供的功能或服务密切相关，或者为支持经过授权的广告时，应用程序才可以使用位置数据。&lt;/p&gt;
&lt;h3 id=&quot;5&quot;&gt;5. 推送通知&lt;/h3&gt;
&lt;p&gt;5.1 不使用苹果推送通知 (APN)应用接口提供推送通知的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;5.2 未从苹果获得Push Application ID便擅自使用APN服务的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;5.3 在首次推送消息或者要求运行推送通知之前未获得用户许可的应用将会被拒绝。&lt;/p&gt;
&lt;p&gt;==5.4 使用推送通知发送敏感个人信息或机密信息的程序将会被拒绝。==&lt;/p&gt;
&lt;p&gt;5.5 使用推送通知发送非请求消息，或用于钓鱼或群发垃圾信息用途的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;5.6 应用程序不可使用推送通知发送广告、促销或任何类型的直销信息。&lt;/p&gt;
&lt;p&gt;5.7 应用程序不能向使用推送通知服务的用户收取费用。&lt;/p&gt;
&lt;p&gt;5.8 使用推送通知会过多利用APN服务的网络流量或带宽或给设备带来过度负担的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;5.9 如果应用程序传送病毒、文件、计算机代码或程序，并且对APN服务的正常运行造成损害或中断，那么该程序将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;6&quot;&gt;6. 游戏中心&lt;/h3&gt;
&lt;p&gt;6.1 向终端用户或任意第三方显示玩家ID的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;6.2 将玩家ID用于任何未经游戏中心条款批准用途的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;6.3 试图进行反向搜索、跟踪、关联、挖掘、获得或利用玩家ID、别名或通过游戏中心获得其他信息的开发者将会iOS开发者计划除名。&lt;/p&gt;
&lt;p&gt;6.4 游戏中心信息（例如排行榜分数），只能用于游戏中心批准的应用程序中。&lt;/p&gt;
&lt;p&gt;6.5 利用游戏中心服务发送非请求信息，或用于钓鱼或群发垃圾邮件的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;6.6 过多使用游戏中心网络流量或带宽的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;6.7 如果程序能够传送病毒、文件、计算机代码或程序，并且对游戏中心服务的正常运行造成损害或中断，该程序将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;7&quot;&gt;7. 广告&lt;/h3&gt;
&lt;p&gt;7.1 人工刷广告浏览量或者广告点击率的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;==7.2 包含空iAd广告的应用程序将会被拒绝。==&lt;br/&gt;例子:使用了广告标识符但是没有展示广告。（审核信息正确填写可以绕过这一案例）&lt;/p&gt;
&lt;p&gt;7.3 主要设计目的在于显示广告的应用程序将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;8&quot;&gt;8. 内容与知识产权&lt;/h3&gt;
&lt;p&gt;8.1 应用程序必须遵守”Guidelines for Using Apple Trademarks and Copyrights”和”Apple Trademark List”中说明的所有条款与条件。&lt;/p&gt;
&lt;p&gt;8.2 任何误导和暗示苹果公司是该应用程序来源或提供商，或者苹果公司以任何形式表示认可其质量或功能的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;8.3 与目前已有苹果产品或者广告主题外观相似或混淆的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;==8.4 在应用程序名称中将苹果产品名拼错的应用程序（例如，GPS for Iphone，iTunz）将会被拒绝。==&lt;strong&gt;注&lt;/strong&gt;，拼写注意大小写:iPhone,iPad,iOS…&lt;/p&gt;
&lt;p&gt;8.5 应用程序不得使用受保护的第三方材料（比如商标、版权以及专利），不能违反第三方使用条款。必须提供使用这些材料的授权许可。&lt;/p&gt;
&lt;p&gt;8.6 若无明确授权许可，从第三方来源处（比如YouTube、SoundCloud以及Vimeo等）下载音乐或者视频内容的应用程序将会被拒绝。（2015.3 新增）&lt;/p&gt;
&lt;h3 id=&quot;9&quot;&gt;9. 媒体内容&lt;/h3&gt;
&lt;p&gt;9.1 不使用媒体播放器框架（MediaPlayer Framework）获取音乐库中媒体内容的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;9.2 用户界面模仿任何iPod或者iTunes界面的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;==9.3 通过蜂窝网络传输的音频流内容每5分钟不得超过5MB。==&lt;br/&gt;&lt;strong&gt;注&lt;/strong&gt;:做音乐播放器的开发者们需要特别关注&lt;/p&gt;
&lt;p&gt;9.4通过蜂窝网络传输超过10分钟的视频流内容必须使用HTTP Live Streaming协议，并且要包含一个基线为192kbps或者更低的HTTP实时流。（2015.3 修正）&lt;/p&gt;
&lt;h3 id=&quot;10&quot;&gt;10. 用户界面&lt;/h3&gt;
&lt;p&gt;10.1 应用程序必须遵守苹果人机界面设计指南中所有的条款和条件，包括：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/UserExperience/conceptual/mobilehig/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;iOS Human Interface Guidelines&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;OS X Human Interface Guidelines&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/tvos/human-interface-guidelines/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Apple TV Human Interface Guidelines&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://developer.apple.com/watch/human-interface-guidelines/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Apple Watch Human Interface Guidelines&lt;/a&gt;.（2015.10 修正）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;（旧版：应用程序必须遵守苹果的《iOS Human Interface Guidelines》中所有的条款和条件。）&lt;/p&gt;
&lt;p&gt;10.2 外观与iOS或Watch OS设备自带应用（比如App Store、iTunes Store和iBookstore）相似的应用程序将会被拒绝。（2015.4 修正）&lt;/p&gt;
&lt;p&gt;10.3 未能按苹果《iOS Human Interface Guidelines》描述正确使用系统提供的项目（比如按钮、图标）的应用将会被拒绝。&lt;/p&gt;
&lt;p&gt;10.4 创建桌面/主屏幕环境或者模拟multi-App插件体验的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;10.5 修改音量大小和铃声/静音等标准开关功能的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;10.6 苹果和我们的客户高度推崇简单、精致、富有创造性以及经过精心设计的界面。虽然需要付出更多，但却非常值得。苹果设立了很高的门槛。如果你的用户界面太过复杂或者水准不高，可能会被拒绝。&lt;/p&gt;
&lt;p&gt;10.7 主要功能为报时的Watch app将会被拒。（2015.4 新增）&lt;/p&gt;
&lt;h3 id=&quot;11&quot;&gt;11. 购买与货币流通&lt;/h3&gt;
&lt;p&gt;11.1 使用App Store以外的渠道解锁或开启附加属性和功能的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;11.2 使用应用内支付系统（IAP）以外的系统购买内容、功能或服务的应用软件将会被拒绝。&lt;/p&gt;
&lt;p&gt;11.3 使用IAP购买实物商品或者用于该软件之外的商品和服务的应用软件将会被拒绝。&lt;/p&gt;
&lt;p&gt;11.4 使用IAP购买积分（信用点）或者其他货币必须在本应用中消费。&lt;/p&gt;
&lt;p&gt;11.5 使用IAP购买已过期积分或其他货币的应用软件将会被拒绝。&lt;/p&gt;
&lt;p&gt;11.6 使用IAP订阅的内容至少要持续7天，而且允许在用户的其他iOS设备间共享。&lt;/p&gt;
&lt;p&gt;11.7 使用IAP购买项目的应用程序必须指派正确的购买类型。&lt;/p&gt;
&lt;p&gt;11.8 使用IAP购买使用iOS、watchOS以及tvOS内置功能（如照相机，陀螺仪）或者苹果品牌周边产品（比如苹果键盘、苹果电容笔）的应用程序将会被拒绝。（2015.10 修正）&lt;/p&gt;
&lt;p&gt;旧版：使用IAP购买iOS内置功能（如照相机，陀螺仪）的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;11.9 含有超过限定时间的内容或服务的应用程序将会被拒绝，除经特定批准的内容（比如电影、电视节目音乐以及书籍）。&lt;/p&gt;
&lt;p&gt;11.10 保险类应用程序必须免费，要遵守发布地区的法律，并且不能使用IAP。&lt;/p&gt;
&lt;p&gt;11.11 一般而言，你的应用程序越贵，我们的评审会越深入。&lt;/p&gt;
&lt;p&gt;11.12 提供订阅功能的应用必须使用IAP，苹果将会按照 Developer Program License Agreement 中的约定与开发者按30/70比例分成。&lt;/p&gt;
&lt;p&gt;==11.13 在应用内使用跳转至外部购买或订阅链接的应用将会被拒，比如”buy”按钮跳转至一个购买电子书的web页面。==&lt;/p&gt;
&lt;p&gt;11.14 只要应用内没有跳转至外部购买、订阅的按钮或链接，苹果允许这些应用读取或展示经批准的、在应用外购买或订阅内容(特别是杂志、报纸、书籍、音频、音乐、视频以及云存储内容)。苹果只能通过应用程序内的购买获得一部分收益。&lt;/p&gt;
&lt;p&gt;11.15 应用程序可以只使用自动更新订阅期刊(报纸、杂志)、商业应用程序(企业类、效率类、专业创意类以及云存储类)和媒体类应用程序(视频、音频、声音)，否则应用程序将被拒绝。&lt;/p&gt;
&lt;p&gt;11.16 当与特定的经过审核的实体产品（比如玩具）结合使用时，应用程序可以使用获得批准的附加特性和功能，只要附加功能完全依赖于该硬件产品（比如一款用于控制望远镜的应用程序）或者也可以在不使用实物产品的情况下使用应用程序，比如成就奖励或者使用IAP。&lt;/p&gt;
&lt;p&gt;11.17 如果应用功能遵照各州和联邦法律，那么应用可以用来促进被认可的虚拟货币的流通。&lt;/p&gt;
&lt;h3 id=&quot;12&quot;&gt;12. 抓取和聚合&lt;/h3&gt;
&lt;p&gt;==12.1 从苹果网站（例如apple.com、iTunes Store、App Store、iTunes Connect以及Apple Developer Programs等）抓取任何信息或者使用苹果网站内容和服务进行排名的应用程序将会被拒绝。 ==&lt;br/&gt;&lt;strong&gt;例子:&lt;/strong&gt;检查版本更新&lt;/p&gt;
&lt;p&gt;12.2 应用软件可以使用获得批准的苹果RSS feeds，例如iTunes Store RSS feeds。&lt;/p&gt;
&lt;p&gt;12.3 只是简单的网页剪切、内容整合或者收集链接的应用程序可能会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;13&quot;&gt;13. 损害设备&lt;/h3&gt;
&lt;p&gt;13.1 怂恿用户以可能造成损害的方式使用苹果设备的应用软件将会被拒绝。&lt;/p&gt;
&lt;p&gt;13.2 快速耗光设备电量或产生过多热量的应用软件将会被拒绝。&lt;/p&gt;
&lt;p&gt;13.3 能导致用户人身伤害的app将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;14&quot;&gt;14. 人身攻击&lt;/h3&gt;
&lt;p&gt;14.1 涉及诽谤、人身攻击性质以及内容狭隘卑鄙的应用软件或者打击特定个人或组织的应用软件将会被拒绝。&lt;/p&gt;
&lt;p&gt;14.2 职业政治讽刺家和幽默作家不受这一条款约束。&lt;/p&gt;
&lt;p&gt;==14.3 展示用户创作内容（UGC）的应用程序必须提供一个过滤不良资讯的方法，一个用户可以标记侵犯性内容的机制，以及可以阻止辱骂用户的能力。==&lt;br/&gt;&lt;strong&gt;注:&lt;/strong&gt;社交类软件需要提供举报和反黄反暴力的机制。&lt;/p&gt;
&lt;h3 id=&quot;15&quot;&gt;15. 暴力&lt;/h3&gt;
&lt;p&gt;15.1 应用程序中出现人或动物被杀、致残以及枪击、刺伤、拷打等受伤情形的真实画面将会被拒绝。&lt;/p&gt;
&lt;p&gt;15.2 出现描绘暴力或虐待儿童等内容的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;15.3 游戏中出现的”敌人”不可指向一个特定种族、文化、一个真实存在的政府、企业或者其他任何现实中的实体。&lt;/p&gt;
&lt;p&gt;15.4 对武器进行真实描述以怂恿非法使用或滥用这些武器的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;15.5包含俄罗斯轮盘赌博内容的游戏将会被拒。&lt;/p&gt;
&lt;h3 id=&quot;16&quot;&gt;16.令人反感的内容&lt;/h3&gt;
&lt;p&gt;16.1 应用程序中出现过于令人反感或者低俗的内容将会被拒绝。&lt;/p&gt;
&lt;p&gt;16.2 在设计上激怒用户或令人感到厌恶的应用程序将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;17&quot;&gt;17.隐私&lt;/h3&gt;
&lt;p&gt;17.1 在未经用户事先许可，或未告知用户如何使用信息以及在何处使用信息的情况下，应用程序不能传输用户数据。&lt;/p&gt;
&lt;p&gt;17.2 要求用户共享电子邮箱地址和出生日期等私人信息才可使用其功能的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;17.3 仅出于遵守适用的儿童隐私法规的目的，应用程序可以要求用户的出生日期（或者使用其他年龄评级机制），但是必须包括一些有用的功能或者娱乐价值，不管用户年龄大小。&lt;/p&gt;
&lt;p&gt;17.4 收集、传输以及分享未成年用户个人信息（比如名字、地址、邮件、位置、照片、视频、绘画、聊天信息以及其他个人数据，或者与以上所述相关的永久性标示符）的应用程序必须遵守应用儿童隐私法规，并且必须包含隐私条款。&lt;/p&gt;
&lt;p&gt;17.5 包含账号注册或者访问用户现有账号的应用程序必须包含隐私策略，否则将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;18&quot;&gt;18. 色情&lt;/h3&gt;
&lt;p&gt;18.1 含有色情素材，也就是《韦氏词典》中定义的”旨在激发情欲，对性器官或性行为的明确描述或展示，而无关美学或情绪感受”的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;18.2 包含用户频繁提供的色情内容的应用程序（比如以前的“Chat Roulette”程序）将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;19&quot;&gt;19.宗教，文化与种族&lt;/h3&gt;
&lt;p&gt;19.1 涉及宗教、文化或种族群体的引用或评论包含诽谤性、攻击性或狭隘内容，或会使特定群体遭受伤害或暴力的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;19.2 程序可以包含或引用宗教经文，程序所提供的引用或翻译必须准确且不会引起误导。评论应该有教育意义，可以令人开阔眼界，而不应有煽动性。&lt;/p&gt;
&lt;h3 id=&quot;20&quot;&gt;20. 竞赛、赌博、彩票以及抽奖&lt;/h3&gt;
&lt;p&gt;20.1 彩票抽奖和竞赛必须由应用程序的开发者或者app所属公司发起。&lt;/p&gt;
&lt;p&gt;20.2 应用程序必须展示彩票抽奖和竞赛的正式规则，并声明苹果不是发起者，也没有以任何方式参与活动。&lt;/p&gt;
&lt;p&gt;20.3 开发者运营一款具有抽奖性质的应用必须经过法律允许，并且抽奖应用必须具备以下特征：报酬、运气以及奖品。&lt;/p&gt;
&lt;p&gt;20.4 允许用户在应用中直接购买彩票或彩券的应用将会被拒。&lt;/p&gt;
&lt;p&gt;20.5 提供真钱游戏（比如体育博彩、扑克牌、赌场游戏、赛马以及彩票）的应用程序必须有应用程序适用地区当地必要的许可和允许，必须限制在这些区域，必须可以从App Store免费下载。&lt;/p&gt;
&lt;p&gt;20.6 使用IAP购买信誉或者货币，且结合真钱游戏的应用将会被拒绝。&lt;/p&gt;
&lt;p&gt;21.慈善与援助&lt;/p&gt;
&lt;p&gt;21.1 包含可以向已认证的慈善组织捐赠功能的应用程序必须是免费的。 &lt;/p&gt;
&lt;p&gt;21.2 捐赠款项的募集必须通过Safari浏览器访问web页面或是手机短消息完成。&lt;/p&gt;
&lt;h3 id=&quot;22&quot;&gt;22. 法律要件&lt;/h3&gt;
&lt;p&gt;22.1 应用程序必须遵守所有发布地区当地法律，开发者有义务了解并遵守所有当地法律。&lt;/p&gt;
&lt;p&gt;22.2 包含虚假，欺诈或误导性陈述的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;22.3 任何用于招徕、促进或鼓励犯罪或明显鲁莽行为的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;22.4 支持非法文件共享的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;22.5 被设计用以非法赌博工具的应用程序（包括点算牌）将会被拒绝。&lt;/p&gt;
&lt;p&gt;22.6 具有匿名或恶作剧拨打电话或发送类似短信/彩信功能的程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;22.7 任何开发暗中收集用户密码或用户私人数据程序的开发者将会从iOS开发者计划中除名。&lt;/p&gt;
&lt;p&gt;22.8 包含非执法机构发布的DUI检查点信息，或者怂恿/协助酒后驾车的应用将会被拒绝。&lt;/p&gt;
&lt;p&gt;22.9 计算药剂用量的应用程序必须由药品制造商或者认可机构发布，比如医院、保险公司以及高校。&lt;/p&gt;
&lt;p&gt;22.10.在未授权的情况下使用iTunes音乐预览的应用程序将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;23&quot;&gt;23. Wallet&lt;/h3&gt;
&lt;p&gt;23.1 Wallet Passes可被用来支付或者接收支付，传递商业信息或者提供验证（比如电影票、飞机票、优惠券以及其他），但把Wallet Passes用于其他用途的应用程序可能会遭到拒绝，并且会被撤销Wallet证书。（2015.9 修正）&lt;/p&gt;
&lt;p&gt;（旧版：Passbook Passes可被用来支付或者接收支付，传递商业信息或者提供验证（比如电影票、飞机票、优惠券以及其他），但把Passbook Passes用于其他用途的应用程序可能会遭到拒绝，并且会被撤销Passbook证书。）&lt;/p&gt;
&lt;p&gt;23.2 Passes必须包含有效的pass发行人有效的联系资料，否则app将会被拒绝，并且Wallet证书也会被取消。（2015.9 修正）&lt;/p&gt;
&lt;p&gt;（旧版：Passes必须包含有效的pass发行人有效的联系资料，否则app将会被拒绝，并且Passbook证书也会被取消。）&lt;/p&gt;
&lt;p&gt;23.3 Passes必须经过实体签名，并基于其名字、商标或者品牌进行分发，否则应用程序将会被拒绝，而Wallet证书也可能会被撤销。（2015.9 修正）&lt;/p&gt;
&lt;p&gt;（旧版：Passes必须经过实体签名，并基于其名字、商标或者品牌进行分发，否则应用程序将会被拒绝，而Passbook证书也可能会被撤销。）&lt;/p&gt;
&lt;h3 id=&quot;24&quot;&gt;24.儿童类别&lt;/h3&gt;
&lt;p&gt;24.1 儿童类别中的应用程序必须包含隐私政策，必须遵守适用的儿童隐私法规。&lt;/p&gt;
&lt;p&gt;24.2 儿童类别中的应用程序不允许包括行为广告（比如app内部基于用户行动的服务广告），任何在应用程序中展示的上下文广告必须适合儿童。&lt;/p&gt;
&lt;p&gt;24.3 儿童类别中的应用程序必须得到家长许可或使用parental gate才能链接至应用程序外部或进行交易。&lt;/p&gt;
&lt;p&gt;24.4 儿童类别中的应用程序必须标明”5岁以下，6-8岁或者9-11岁”。&lt;/p&gt;
&lt;h3 id=&quot;25&quot;&gt;25.扩展&lt;/h3&gt;
&lt;p&gt;25.1 包含扩展的应用程序必须遵照 App Extension Programming Guide要求。&lt;/p&gt;
&lt;p&gt;25.2 包含扩展的应用程序必须提供某些功能（辅助屏幕，附加设置），否则将会被拒绝。&lt;/p&gt;
&lt;p&gt;25.3 如果扩展的视图中包含营销推广、广告或者IAP内容，那么包含该扩展的应用将会被拒绝。&lt;/p&gt;
&lt;p&gt;25.4 键盘扩展必须提供一个切换至下个键盘的方法。&lt;/p&gt;
&lt;p&gt;25.5 键盘扩展必须具有离线访问功能，否则将会被拒绝。&lt;/p&gt;
&lt;p&gt;25.6 键盘扩展必须提供和 App Extension Programming Guide 描述一致的数字和十进键盘类型，否则将会被拒绝。&lt;/p&gt;
&lt;p&gt;25.7 提供键盘扩展的应用必须拥有基本的功能分类和隐私政策，否则将会被拒绝。&lt;/p&gt;
&lt;p&gt;25.8 提供键盘扩展的应用程序只允许收集用户活动以增强键盘扩展在iOS设备上的功能，否则将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;26&quot;&gt;26.HomeKit&lt;/h3&gt;
&lt;p&gt;26.1使用HomeKit框架的应用程序必须有提供家庭自动化服务的主要目的。&lt;/p&gt;
&lt;p&gt;26.2 使用HomeKit框架的应用程序必须在营销文本中说明用途，同时必须提供隐私政策，否则将会被拒绝。&lt;/p&gt;
&lt;p&gt;26.3应用程序不允许将从HomeKit API收集的数据用于广告宣传或者其他基于使用的数据挖掘。&lt;/p&gt;
&lt;p&gt;26.4 出于其他目的使用从HomeKit API收集的数据，而不是用于提高用户体验或者家庭自动化功能中硬件/软件性能，这类应用将会被拒绝。&lt;/p&gt;
&lt;h3 id=&quot;27&quot;&gt;27.HealthKit和人体生物学研究&lt;/h3&gt;
&lt;p&gt;27.1 使用HealthKit或者ResearchKit框架（出于健康目的用于进行人体生物学研究的框架）的应用程序，必须遵守其所有适用区域的法律，以及iOS Developer Program License Agreement中的3.3.28和3.39条款。（2015.3 新增）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;27.2 将虚假或者错误的数据写入HealthKit的应用程序将会被拒绝。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;27.3 使用HealthKit框架的应用程序在iCloud中储存用户健康信息将会被拒绝。&lt;/p&gt;
&lt;p&gt;27.4 应用程序不允许使用通过HealthKit API或者进行人体生物学研究收集的用户数据，或者将其泄露给第三方用作广告宣传或者基于使用的数据挖掘目的，除了改善健康、医疗、健康管理以及医学研究。（2015.3 修正）&lt;/p&gt;
&lt;p&gt;27.5 未经用户许可与第三方分享通过HealthKit API获得的用户数据的应用程序将会被拒绝。&lt;/p&gt;
&lt;p&gt;== 27.6 使用HealthKit框架的应用程序必须在营销文本中说明集成了Health app，同时必须在app用户界面清楚阐释HealthKit的功能。==&lt;/p&gt;
&lt;p&gt;例如: 在 itunes connect 的 app description 中，写明：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;*XXX 会在您的授权允许下获取苹果自带应用“健康”中的运动步数用于XXX&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;并在提交给审核员的Note中，注明App内的何处写明了需使用”健康”软件。&lt;/p&gt;
&lt;p&gt;27.7 使用HealthKit框架或者进行人体生物学研究的应用程序必须提供隐私政策，否则将会被拒绝。（2015.3 修正）&lt;/p&gt;
&lt;p&gt;27.8 提供诊断、治疗建议，或者控制诊断疾病的硬件，或者治疗疾病的应用程序，若没有根据要求提供书面的监管审批，将会被拒绝。&lt;/p&gt;
&lt;p&gt;27.9 收集人体生物学研究相关数据的应用程序必须要获得参与者的许可，对于未成年人，应用程序要得到其父母或者监护人的许可。许可内容必须包括：(a)研究的性质、目的以及持续性；(b)参与流程、风险以及受益（福利）；(c)信息的机密性和数据处理（包括与任何与第三方的共享）；(d)参与者问题切入点；(e) 取消方法（2015.3 新增）&lt;/p&gt;
&lt;p&gt;27.10 进行健康相关的人体生物学研究的应用程序必须得到独立伦理审查委员会的批准。并根据要求提供证明。（2015.4 新增）&lt;/p&gt;
&lt;h3 id=&quot;28&quot;&gt;28.TestFlight&lt;/h3&gt;
&lt;p&gt;28.1应用程序仅能使用TestFlight对以公开发布为目的的应用进行beta版测试，且必须遵守完整的App Review Guidelines。&lt;/p&gt;
&lt;p&gt;28.2 当版本中包含的内容或功能有重大变化时，使用TestFlight的应用程序必须提交审核。&lt;/p&gt;
&lt;p&gt;28.3 使用TestFlight的应用程序不允许分发给测试者，以作为任何形式的补偿。&lt;/p&gt;
&lt;h3 id=&quot;29&quot;&gt;29. Apple Pay&lt;/h3&gt;
&lt;p&gt;29.1使用Apple Pay的应用程序必须在出售任何商品或者服务之前为用户提供所有材料的购买信息，否则将会被拒绝。使用Apple Pay进行重复付款（译者注：定期付款）的应用程序必须提供最低限度续费期限，付费将持续直至被取消，每个阶段所付款额，费用付款方为客户，以及如何取消等。（2015.3 修正）&lt;/p&gt;
&lt;p&gt;29.2 使用Apple Pay的应用程序必须正确使用&lt;a href=&quot;https://developer.apple.com/apple-pay/Apple-Pay-Identity-Guidelines.pdf&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Apple Pay Identity Guidelines&lt;/a&gt;中的Apple Pay标识和用户界面元素，否则将会被拒绝。（2015.3 修正）&lt;/p&gt;
&lt;p&gt;29.3 使用Apple Pay作为购买机制的应用程序所提供的商品或服务不能触犯任何交付地范围内的法律，也不能用作任何非法目的。&lt;/p&gt;
&lt;p&gt;29.4 使用Apple Pay的应用程序必须提供隐私政策，否则将会被拒绝。&lt;/p&gt;
&lt;p&gt;29.5 只有为了促进或提高商品和服务的交付，或者依照法律要件，使用Apple Pay的应用程序才能与第三方分享通过Apple Pay获得的数据。&lt;/p&gt;
&lt;p&gt;动态文档&lt;/p&gt;
&lt;p&gt;这份文档展现了我们在竭尽所能向您分享我们对提交到App Store的程序的审查方式，我们希望您在开发和提交程序时，这份指南能对您有所帮助。这是一份动态文档，随着新程序和新情况的发生会有所变化。我们会定期更新，以反映这些变化。&lt;/p&gt;
&lt;p&gt;感谢您参与到iOS的开发中来。虽然此文档是一份”不该做事宜”的列表，但也请将那份短得多的”必做事宜”列表牢记在心。最重要的是，与我们一道 共同努力让用户感到惊奇和欣喜。用创新方式向他们展示世界，让他们用前所未有的方式与之交流。根据我们的经验，无论是在功能和用户界面上，用户确实会对完善的程序有所响应。更进一步，给他们期望之外的东西，带他们去从未去过的地方。我们愿意提供帮助。&lt;/p&gt;</content:encoded></item><item><title>利用HeaderDoc自动生成API文档</title><link>https://www.shengpan.net/blog/headerdoc/</link><guid isPermaLink="true">https://www.shengpan.net/blog/headerdoc/</guid><description>最近在为公司写框架和组件库。大家都建议在文档上需要更加完善一些。于是在思考如何规范地完善文档？ 面向非技术型的boss们的说明性文档，手工写即可。面向组件使用者的文档呢？一方面，要保证注释的完整性，以保证其他同事在使用的时候只看注释即可。另一方面又需</description><pubDate>Sun, 24 Jan 2016 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;最近在为公司写框架和组件库。大家都建议在文档上需要更加完善一些。于是在思考如何规范地完善文档？&lt;br/&gt;面向非技术型的boss们的说明性文档，手工写即可。面向组件使用者的文档呢？一方面，要保证注释的完整性，以保证其他同事在使用的时候只看注释即可。另一方面又需要要一份文本文档，以便随时查阅。如何同时做到这两点？&lt;/p&gt;
&lt;p&gt;关于文档，业界有一些成熟的解决方案。例如评价颇高的&lt;a href=&quot;https://github.com/tomaz/appledoc&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;AppleDoc&lt;/a&gt;，还有从Xcode 5,iOS7开始集成在Xcode中的&lt;a href=&quot;https://developer.apple.com/library/mac/documentation/DeveloperTools/Conceptual/HeaderDoc/usage/usage.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;HeaderDoc&lt;/a&gt;。本着一切以官方为准的原则，选择了HeaderDoc来完成这项工作。&lt;/p&gt;
&lt;h3 id=&quot;用HeaderDoc有什么好处？&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#用HeaderDoc有什么好处？&quot; title=&quot;用HeaderDoc有什么好处？&quot;&gt;&lt;/a&gt;用HeaderDoc有什么好处？&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;与Xocde兼容&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;将鼠标移动到某一行方法上，按option+鼠标左键试试？&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-13-32-04-2.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;可以自动导出文档&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-13-34-03-1.png&quot;/&gt;&lt;br/&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-13-36-47-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;居然如此炫酷，还不赶紧跟我一起用起HeaderDoc,走(tiao)上(jin)人(wen)生(dang)巅(da)峰(keng)？&lt;/p&gt;
&lt;h3 id=&quot;HeaderDoc-的注释标准&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#HeaderDoc-的注释标准&quot; title=&quot;HeaderDoc 的注释标准&quot;&gt;&lt;/a&gt;HeaderDoc 的注释标准&lt;/h3&gt;&lt;p&gt;HeaderDoc的注释，一般我们会用到以下几种：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;头文件注释&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;头文件基本信息。这个用在每个源代码文件的头文件的最开头。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!
 
 @header UIImage+Scale.h
 
 @abstract 图片压缩的Category
 
 @author Created by Pan on 16/1/24.
 
 @version 1.2.0 16/1/24 Creation
  
 */&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@header&lt;/code&gt; 与该源代码文件的名字一致&lt;/li&gt;
&lt;li&gt;&lt;code&gt;@abstract&lt;/code&gt; 关于这个源代码文件的一些基本描述&lt;/li&gt;
&lt;li&gt;&lt;code&gt;@author&lt;/code&gt; Sheng Pan (作者信息)&lt;/li&gt;
&lt;li&gt;&lt;code&gt;@version&lt;/code&gt; 1.2.0 2012/01/20 Creation (此文档的版本信息)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;类注释&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;关于此类的一些信息。此注释用在类声明的开头。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!

@class PSCarouselView

@abstract 轮播控件，实现了常见的图片轮播功能。

*/&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@class&lt;/code&gt; 与该类名一致&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;属性注释&lt;/strong&gt;&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!

@property nameLabel

@abstract 用于显示用户名的Label

*/&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@property&lt;/code&gt; 与该属性名一致&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;方法注释&lt;/strong&gt;&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!
 
 @abstract 将图片等比缩小
 
 @discussion 将图片等比缩小,注意:此方法在主线程运行，处理大量图片请使用scaleImageOnBackgroud:
 
 @param ratio 缩小的倍数。例如，如想缩小为原图的1/2 ratio = 2.0
 
 @result UIImage
 
 */&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@discussion&lt;/code&gt; 该方法的详细描述，包括方法的一些注意事项，适用情况条件等等。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;枚举注释&lt;/strong&gt;&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!
 
 @enum Gender
 
 @abstract 性别枚举
 
 @constant GenderUnknow 性别未知
 
 @constant GenderMale 男

 @constant GenderFemale 女

 */&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@enum&lt;/code&gt; 与枚举名称一致&lt;/li&gt;
&lt;li&gt;&lt;code&gt;@constant&lt;/code&gt; 与枚举值一致，后面添加描述&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Category注释&lt;/strong&gt;&lt;br/&gt;&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!
 
 @category  Scale
 
 @abstract  UIImage的Category,添加图片压缩的相关功能
 
 */&lt;/code&gt;&lt;/pre&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@category&lt;/code&gt; 与Category名称一致&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Protocol注释&lt;/strong&gt;&lt;br/&gt;&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*!

@protocol HTModelCallBack

@abstract Model的回调接口。

@discussion 想接收Model回调的类，申明并实现此接口，即可获取从HTBaseModel中回调的信息。注意：接收回调的前提，是使用DESIGNATED_INITIALIZER来初始化HTBaseModel(或其子类).

*/&lt;/code&gt;&lt;/pre&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;@Protocol&lt;/code&gt; 与Protocol名称一致&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;常用的注释基本上就是这些，如果还需要了解更多注释的关键字请查阅&lt;a href=&quot;https://developer.apple.com/library/mac/documentation/DeveloperTools/Conceptual/HeaderDoc/usage/usage.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;官方文档&lt;/a&gt;。&lt;/p&gt;
&lt;h3 id=&quot;自动生成标准注释&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#自动生成标准注释&quot; title=&quot;自动生成标准注释&quot;&gt;&lt;/a&gt;自动生成标准注释&lt;/h3&gt;&lt;p&gt;以上的注释格式如此繁琐，手工输入绝对不是我等懒鬼的作风。自动生成注释有以下几种方法&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;修改Xcode模版文件，一劳永逸。&lt;/li&gt;
&lt;li&gt;利用Xode的code snapshot，快速编写注释。&lt;/li&gt;
&lt;li&gt;fork一份&lt;a href=&quot;https://github.com/onevcat/VVDocumenter-Xcode&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;VV-Documentor-Xcode&lt;/a&gt;然后修改里面的注释风格。（VV-Documentor-Xcode原来的注释风格不支持导出文档）。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;后两种不多做介绍，在此介绍一下修改Xcode模版文件的方法。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;打开finder，前往如下路径&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates/File Templates/Source/Cocoa Touch Class.xctemplate&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;我们会看到这样一个目录&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-13-53-50.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;每个文件夹下面的文件，就是各种系统类(包括你继承下来的子类)的模版文件。修改哪个文件夹下的模版文件，创建对应类(和继承自其子类的类)时，就会自动生成模版里预定的注释。&lt;/p&gt;
&lt;p&gt;文件夹内包含了.h和.m两份文件，分别对应.h和.m文件的模版&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/5.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;我们打开.h模版文件，可以看到如下信息&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-13-55-14.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;此处有几个系统的宏&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;FILENAME&lt;/code&gt;：文件名&lt;/li&gt;
&lt;li&gt;&lt;code&gt;PROJECTNAME&lt;/code&gt;：项目名&lt;/li&gt;
&lt;li&gt;&lt;code&gt;FULLUSERNAME&lt;/code&gt;：当前mac用户全称&lt;/li&gt;
&lt;li&gt;&lt;code&gt;DATE&lt;/code&gt;：日期&lt;/li&gt;
&lt;li&gt;&lt;code&gt;COPYRIGHT&lt;/code&gt;：版权声明&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;我们将头文件修改为如下格式，在创建类的时候就可以自动生成我们需要的注释格式了。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;/*! 

  @header ___FILENAME___

  @abstract &amp;lt;#abstract#&amp;gt;

  @author Created by ___FULLUSERNAME___ on ___DATE___.

  @version &amp;lt;#version#&amp;gt; ___DATE___ Creation

___COPYRIGHT___

 */

___IMPORTHEADER_cocoaTouchSubclass___

/*!
 
  @class ___FILEBASENAMEASIDENTIFIER___
 
  @abstract &amp;lt;#description#&amp;gt;
 
 */
@interface ___FILEBASENAMEASIDENTIFIER___ : ___VARIABLE_cocoaTouchSubclass___

@end&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;其他文件如法炮制即可。&lt;/p&gt;
&lt;p&gt;==*&lt;em&gt;注意:&lt;/em&gt;== 记得逐一修改&lt;code&gt;Cocoa Touch Class.xctemplate&lt;/code&gt;文件夹内每一个类的模版文件。只有修改过的类和其子类会起作用。&lt;/p&gt;
&lt;h3 id=&quot;自动导出文档。&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#自动导出文档。&quot; title=&quot;自动导出文档。&quot;&gt;&lt;/a&gt;自动导出文档。&lt;/h3&gt;&lt;p&gt;规范的注释标好后，导出文档就很方便了。有两种方法可以导出文档。&lt;/p&gt;
&lt;h4 id=&quot;用命令行导出文档&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#用命令行导出文档&quot; title=&quot;用命令行导出文档&quot;&gt;&lt;/a&gt;用命令行导出文档&lt;/h4&gt;&lt;p&gt;首先输出文档&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;headerdoc2html -o DESTINATION_PATH PROJECT_PATH&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;DESTINATION_PATH&lt;/code&gt;：文档输出目标文件夹。如&lt;code&gt;~/Desktop/documentation&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;PROJECT_PATH&lt;/code&gt; ：项目目录。如&lt;code&gt;~/Desktop/project&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;然后创建一个文档索引&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;gatherheaderdoc DESTINATION_PATH INDEX_PAGE_NAME&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;DESTINATION_PATH&lt;/code&gt;：文档输出目标文件夹。如&lt;code&gt;~/Desktop/documentation&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;INDEX_PAGE_NAME&lt;/code&gt;：索引页的名字。如&lt;code&gt;index.html&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;用Xcode-Build一份文档&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#用Xcode-Build一份文档&quot; title=&quot;用Xcode Build一份文档&quot;&gt;&lt;/a&gt;用Xcode Build一份文档&lt;/h4&gt;&lt;p&gt;这个方法本质上也是用命令行导出文档。无非是可以不再需要手动管理文档路径，每个项目可以对应一个文档路径。用流行的话来说，就是一次配置，到处留情。哦不，是一次配置，自动运行。&lt;/p&gt;
&lt;p&gt;首先在你的项目中新建一个target。类型选择为Other-Aggregate。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-14-28-23.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;在Target的Build-Phases中，点击加号，选择New Run Phases Script。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2016/01/-----2016-01-24-14-26-41-1.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;粘贴如下脚本（注意修改你自己的工程目录和导出目录）&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;# shell script goes here

headerdoc2html -o ~/Desktop/doc /Users/pan/DEV/iOS/ios-standardization/Example/Pods/Headers/Public/HTStandard

gatherheaderdoc ~/Desktop/doc index.html

exit 0&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;最后，选择这个target，并Run。然后就等待奇迹的发生吧。&lt;/p&gt;</content:encoded></item><item><title>[译] iOS 9 开发小技巧</title><link>https://www.shengpan.net/blog/top-tips-for-ios9/</link><guid isPermaLink="true">https://www.shengpan.net/blog/top-tips-for-ios9/</guid><description>“小黄鸭”法不仅适用于debug,也适用于学习新知识。表达是最好的吸收。 本文原文 发表在realm.io上。我翻译并整理成此文。希望可以为国内的iOS朋友提供一些资料。</description><pubDate>Tue, 15 Dec 2015 00:00:00 GMT</pubDate><content:encoded>&lt;h3&gt;前言&lt;/h3&gt;&lt;p&gt;“小黄鸭”法不仅适用于debug,也适用于学习新知识。表达是最好的吸收。&lt;a href=&quot;https://realm.io/news/tips-for-ios-9-development/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;本文原文&lt;/a&gt;发表在realm.io上。我翻译并整理成此文。希望可以为国内的iOS朋友提供一些资料。&lt;/p&gt;
&lt;h3&gt;LayoutGuide&lt;/h3&gt;
&lt;p&gt;在iOS9.0 和 OS X10.11中，分别有两个新的类：&lt;code&gt;UILayoutGuide&lt;/code&gt; 和 &lt;code&gt;NSLayoutGuide&lt;/code&gt;。他们可以作为一种类似View的对象，参与到AutoLayout的布局约束中。作为一种新的布局解决方案,这两个类的出现使你无需再创建、显示无关的View了。举个栗子，原本需要一个空的&lt;code&gt;UIView&lt;/code&gt;占位的地方，现在只需要用&lt;code&gt;UILayoutGuide&lt;/code&gt;去替代它就可以了。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;// 创建LayoutGuide
let layoutGuideA = UILayoutGuide()
let layoutGuideB = UILayoutGuide()

// 添加到View上
let view: UIView = ...
view.addLayoutGuide(layoutGuideA)
view.addLayoutGuide(layoutGuideB)

// 用UILayoutGuide来添加布局约束
layoutGuideA.heightAnchor.constraintEqualToAnchor(layoutGuideB.heightAnchor).active = true

// 设置Identifier，为了方便DEBUG
layoutGuideA.identifier = &quot;layoutGuideA&quot;
layoutGuideB.identifier = &quot;layoutGuideB&quot;

// ...然后看看他们的Frame吧
print(&quot;layoutGuideA.layoutFrame -&amp;gt; \(layoutGuideA.layoutFrame)&quot;)&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;NSLayoutAnchor&lt;/h3&gt;&lt;p&gt;iOS9中另一个新增的API是&lt;code&gt;NSLayoutAnchor&lt;/code&gt;。它的出现不仅仅是让使用代码添加约束变得简洁明了。通过该类强大的静态检查能力，还提供了额外的约束正确定保证。举个栗子，考虑以下使用&lt;code&gt;NSLayoutConstraint&lt;/code&gt;API创建的约束会出现什么问题：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;NSLayoutConstraint *constraint = 
    [NSLayoutConstraint constraintWithItem:view1 
                                 attribute:NSLayoutAttributeLeading 
                                 relatedBy:NSLayoutRelationEqual 
                                    toItem:view2 
                                 attribute:NSLayoutAttributeTop 
                                multiplier:1.0 
                                  constant:0.0];&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这个约束是无效的。因为你将一个X轴上的属性(leading)同一个Y轴属性(top)绑定。然而，这个错误可以毫无警告地通过编译，在运行的时候&lt;strong&gt;默默地&lt;/strong&gt;就失效了，最终留下一个出错的布局。由于这个错误不会产生任何的日志信息，导致极难debug。假如工程里有许多(成千上万)这样的约束代码，那对于维护来说真是一场噩梦。&lt;/p&gt;
&lt;p&gt;好在&lt;code&gt;NSLayoutAnchor&lt;/code&gt;利用了”泛型”解决了这个问题。”泛型”现在在Swift和Objective-C中都已经得到了支持。&lt;code&gt;UIView&lt;/code&gt;中&lt;code&gt;NSLayoutAnchor&lt;/code&gt;相关的存取方法，明确指出了需要哪些继承自&lt;code&gt;NSLayoutAnchor&lt;/code&gt;的子类。这些子类被分为了三类，X轴，Y轴，和尺寸(宽/高)，一种类型的Anchor只允许绑定约束到另外一个相同类型的Anchor上。通过指定&lt;code&gt;NSLayoutAnchor&lt;/code&gt;中参数的类型，这个API可以通过类型检查，来避免创建出例子中无效的约束。&lt;/p&gt;
&lt;p&gt;我们回到之前的例子，用&lt;code&gt;NSLayoutAnchor&lt;/code&gt;来实现一下这个约束：&lt;br/&gt;&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;NSLayoutConstraint *constraint = 
    [view1.leadingAnchor constraintEqualToAnchor:view2.topAnchor];&lt;/code&gt;&lt;/pre&gt;&lt;/p&gt;
&lt;p&gt;相比旧的API，新的API非常明显地提升了代码可读性。并且，当你传入错误的Anchor类型时，新的API会抛出一个”Incompatible pointer type”警告，因为编译器知道这个是两个不同的类。&lt;/p&gt;
&lt;p&gt;想要了解更多，请查阅&lt;a href=&quot;https://developer.apple.com/library/prerelease/ios/documentation/AppKit/Reference/NSLayoutAnchor_ClassReference/index.html#//apple_ref/occ/instm/NSLayoutAnchor/constraintEqualToAnchor:constant:&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;NSLayoutAnchor官方文档&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;HTTPS 和 HTTP&lt;/h3&gt;&lt;p&gt;Apple介绍了iOS9中的&lt;a href=&quot;https://developer.apple.com/library/prerelease/ios/technotes/App-Transport-Security-Technote/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;App Transport Security&lt;/a&gt;，它要求所有App在默认情况下使用HTTPS来进行网络请求。由于不是所有的服务器都运行在HTTPS环境下，Apple也提供了相关的方法来禁用ATS。&lt;/p&gt;
&lt;p&gt;如果你的App需要请求的网址不可控（比如说UIWebVeiw请求的网站，有可能是HTTP的，也有可能是HTTPS的)，那么你应当将Info.plist文件中的&lt;code&gt;NSAllowsArbitraryLoads&lt;/code&gt;设置为YES，来完全禁用ATS。出于数据安全考虑，在完全禁用ATS的情况下，你也应该为某些重要的站点打开ATS。你可以通过&lt;code&gt;NSExceptionDomains&lt;/code&gt;key来禁用/启用特定的站点的ATS。参照如下图片:&lt;br/&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/12/ios9-tips-conrad-info-plist.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;该plist文件允许用户在HTTP环境下下载文件，但是只能在HTTPS情况下访问”workflow.is”&lt;/p&gt;
&lt;p&gt;需要提醒的是，ATS的设置只针对当前bundle。这意味着你不仅需要在你主项目的info.plist中添加ATS相关的Key,同时也需要在其他bundle下的info.plist中添加相关配置。&lt;/p&gt;
&lt;p&gt;关于iOS9的适配，github上有一个中文项目&lt;a href=&quot;https://github.com/ChenYilong/iOS9AdaptationTips&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;iOS9AdaptationTips&lt;/a&gt;可以提供很大的帮助。&lt;/p&gt;
&lt;p&gt;&lt;/p&gt;&lt;h3 id=&quot;StoryboardReference&quot;&gt;Storyboard Reference&lt;/h3&gt;&lt;br/&gt;Storyboard真是让人又爱又恨，每个在多人合作项目中使用Storyboard的人，都遇到过Storyboard文件的冲突。类似的冲突解决起来比较棘手，常常是以回滚告终。这一点直接造成了一些团队放弃使用Storyboard开发而推荐纯代码布局。&lt;p&gt;&lt;/p&gt;
&lt;p&gt;如果需要使用Storyboard，但又想最大化地避免冲突呢？最好的方法就是将UI划分的更小的、不同的Storyboard文件中。在过去如果想要做到这一点，意味跨Storyboard的跳转方法，需要在代码里完成：&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;UIStoryboard *destinationStoryboard = [UIStoryboard storyboardWithName:@&quot;StoryboardName&quot; bundle:nil];
DestinationViewController *vc = [destinationStoryboard instantiateViewControllerWithIdentifier:@&quot;identifier&quot;];

//一顿设置
...

[self.navigationController pushViewController:vc animated:YES];&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在Xcode7 和 iOS 9中，只需要用Storyboard Reference就可以用Segue轻松实现跨Storyboard的跳转了。&lt;code&gt;Storyboard Reference&lt;/code&gt;的出现，保留了单个Storyboard文件跳转的优点的同时，提供了多Storyboard文件时利于合并的便利。&lt;/p&gt;
&lt;p&gt;开始分割你那巨大的Storyboard文件吧。最快的方法是:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;缩放Storyboard&lt;/li&gt;
&lt;li&gt;框选一组逻辑相近的scenes&lt;/li&gt;
&lt;li&gt;选择Editor &amp;gt; Refactor to Storyboard…&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;自动Refactord的故事板文件会为每一个scenes留下一个&lt;code&gt;UIStoryboard Reference&lt;/code&gt;，并且在需要的地方自动创建可读性不好的Storyboard ID。所以就个人来说，我更推荐手动复制scenes到新的故事板文件中，然后在源文件中删除这些scenes并手动添加&lt;code&gt;Storyboard Reference&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;如果你已经有多个故事板文件了，为自己庆祝一下吧——你又可以精简你的代码了！从Object库中拖拽一个&lt;code&gt;UIStoryboard Reference&lt;/code&gt;，并配置segue。然后选取你手动跳转的代码，大力地按下删除键吧！&lt;/p&gt;</content:encoded></item><item><title>谈谈组件封装的思路和实现--PSCarouselView</title><link>https://www.shengpan.net/blog/pscarouselview/</link><guid isPermaLink="true">https://www.shengpan.net/blog/pscarouselview/</guid><description>前两天面试了一个应聘者，他的演示项目里有广告轮播功能。恰好之前我封装过一个实现了此功能的控件，于是就顺着他广告轮播的实现一直往下聊，从需求的抽象一直聊到各种实现的细节和需要考虑的问题等等。组件的封装是开发中比较有趣的一件事。今天我们就拿轮播控件举例，</description><pubDate>Thu, 12 Nov 2015 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;前两天面试了一个应聘者，他的演示项目里有广告轮播功能。恰好之前我封装过一个实现了此功能的控件，于是就顺着他广告轮播的实现一直往下聊，从需求的抽象一直聊到各种实现的细节和需要考虑的问题等等。组件的封装是开发中比较有趣的一件事。今天我们就拿轮播控件举例，聊聊组件的封装。&lt;/p&gt;
&lt;p&gt;授人予渔先要授人予鱼。&lt;a href=&quot;https://github.com/DeveloperPans/PSCarouselView&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;先给出鱼(PSCarouselView)&lt;/a&gt;，再慢慢讲渔。&lt;/p&gt;
&lt;p&gt;##分析需求&lt;br/&gt;一般来说，我们在封装组件的时候，会先思考以下几点&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;这个组件要做什么&lt;/li&gt;
&lt;li&gt;这个组件&lt;strong&gt;至少&lt;/strong&gt;需要知道哪些信息&lt;/li&gt;
&lt;li&gt;这个组件会反馈哪些信息&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这个阶段，我们还不会考虑组件的具体实现，仅仅对其做抽象。我们要做的东西不仅仅是适用于单个项目的，而应该是通用的，可以适应大部分同种类需求的。&lt;/p&gt;
&lt;h4&gt;Scene I&lt;/h4&gt;&lt;p&gt;BA说，客户要在首页加个轮播。于是半天后设计师出了张图，看起来大概像这样：&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/11/-----1.jpg&quot;/&gt; &lt;/p&gt;
&lt;p&gt;我们按照上面的思路，拆分一下这个需求。&lt;/p&gt;
&lt;h3&gt;这个组件要做什么&lt;/h3&gt;&lt;p&gt;显而易见的：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;1.展示多张图片&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;2.可以向左向右翻页&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;3.PageControl的状态会根据图片的滚动而相应改变&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;隐含可能要做的：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;1.支持左右两侧无限循环滚动&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;2.自动轮播&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;3.支持手动滑动&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;4.支持点击并进行相关的响应&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;5.图片的缓存&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;这个组件&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;至少&lt;/strong&gt;需要知道哪些信息&lt;br/&gt;一个封装得优秀的复杂度不高组件就像一个魔法盒子，只需要触发启动开关，就可以达到你期待的效果。极简的触发参数和条件是组件封装的精髓。在内容型App中，轮播图一般会用作推荐内容展示区域。在O2O类App中，轮播图一般会用作广告位。因此轮播区域图片的内容绝大多数都是动态的。在一般的C/S开发中，客户端要获取存储在服务器上的图片会获取它的URL,然后在需要的时候根据URL异步地加载这些图片。因此，我们找出了的轮播空间第一个必备条件：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;一个图片URL地址数组。&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@property (nonatomic, strong) NSArray *imageURLs;/**&amp;lt; 必须赋值。只要给这个imageURL赋值，会自动获取图片*/
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这个时候我们已经可以根据数组内的URL,数组内URL的数量，完成轮播效果了。但还不够完善。试想，当数组为空的时候，我们的轮播控件是一个什么状态？网络比较慢，图片还在加载中的时候，我们的轮播控件是什么状态？就目前来说—-空白一片。&lt;/p&gt;
&lt;p&gt;每个App都有每个App的设计，但无论如何谁也不会容忍首页最醒目的部分出现一大片空白，因此占位图是必须的。我们告诉我们的控件，“没有图片的时候别傻愣着，显示这张图”。必备条件二：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;占位图&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@property (nonatomic, strong) UIImage *placeholder;/**&amp;lt; 没有轮播图时的占位图*/
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;有了以上信息我们的轮播控件已经可以在运行得比较好了。但是缺少了一定的定制性，能满足的需求面还不够广。比如说，让控件在需要自动轮播的地方自动轮播，在不需要自动轮播的地方保留无限滚动的特性，可以手动拨动？（之前有个产品提过这样的需求）比如说,这个控件是否应该提供可选的PageControl实现？依据设计师给的图不同，我们可能需要实现不同的PageControl，不管是颜色，布局，还是其可见隐藏都可能会有不同。这一部分复杂度不应该归到轮播控件中。但考虑到一些快速开发的需求,控件还是提供了一个默认选项。这些都是让控件变得更加可配置和灵活（同时也变得复杂）的可选信息。综上我们大概可以整理出以下属性：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@property (nonatomic,getter=isAutoMoving)      BOOL autoMoving;/**&amp;lt; 是否自动轮播,默认为NO*/
@property (nonatomic,getter=isShowPageControl) BOOL showPageControl;/**&amp;lt; 是否展示默认的PageControl，默认为YES*/
&lt;/code&gt;&lt;/pre&gt;&lt;h3&gt;这个组件会反馈哪些信息&lt;/h3&gt;&lt;p&gt;上一点中，如果使用者需要自己实现PageControl，那么当前控件滚动到哪一页了，应该给出反馈。&lt;/p&gt;
&lt;p&gt;不论在O2O的App中，还是资讯类App中，用户点击轮播必定会有相对应的响应，例如之乎日报点击跳转到对应的文章，淘宝点击查看大图等。因此用户点击的信息也必须反馈出来，以让控制器根据用户的操作进行不同的响应。&lt;/p&gt;
&lt;p&gt;View层对Controller层的反馈一般有两种，一种是Target-Action，一种是Delegate。此处我们类似UITableView,给出一定的代理方法。遵循苹果的设计规范，让使用的开发者容易上手。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@protocol PSCarouselDelegate &amp;lt;NSObject&amp;gt;
@optional
/**
 *  告诉代理滚动到哪一页了
 *
 *  @param carousel self
 *  @param page     已经计算好，直接使用即可
 */
- (void)carousel:(PSCarouselView *)carousel didMoveToPage:(NSUInteger)page;

/**
 *   告诉代理用户点击了某一页
 *
 *  @param carousel
 *  @param index  imageURL的index  
 */
- (void)carousel:(PSCarouselView *)carousel didTouchPage:(NSUInteger)page;
@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;至此，轮播组件的架子已经明晰，剩下的就是如何实现，以及实现的时候需要考虑的一些细节。&lt;/p&gt;
&lt;p&gt;##实现过程&lt;/p&gt;
&lt;h3&gt;选择基类&lt;/h3&gt;&lt;p&gt;苹果的UIKit提供了非常多优秀的类，可以作为我们轮播视图的基类。根据以上的分析，我们根据直觉，立马可以联想到以下三个类：&lt;br/&gt;&lt;code&gt;UIPageViewController&lt;/code&gt;、&lt;code&gt;UIScrollView&lt;/code&gt;、&lt;code&gt;UICollectionView&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;UIPageViewController&lt;/code&gt;提供了非常好的翻页封装，仅需要指定翻页的方向，和子ViewController的数组，就可以提供类似轮播的功能。并且&lt;code&gt;UIPageViewController&lt;/code&gt;提供了供翻页的接口和必要的反馈信息，定义在&lt;code&gt;UIPageViewControllerDelegate&lt;/code&gt;协议中。用UIPageViewController,我们只需要将每个轮播页封装成一个仅包含一个UIImageView的ViewController，并将其设为UIPageViewController的ViewControllers，并实现它的代理方法就很容易实现我们的轮播图。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;UIScrollView&lt;/code&gt;提供了最基本的滚动封装。采用UIScrollView作为基类，需要自己根据图片的数量计算ContentSize,并在ScrollView相对应的代理方法中，根据Frame相关信息来计算页码，会比UIPageViewController稍微复杂。但好在，它是一个&lt;code&gt;View&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;UICollectionView&lt;/code&gt;做为UIScrollView的子类提供了比UIScrollView更好的封装，也提供了”翻页”的接口，并提供了一系列定位CollectionView的状态信息。相比UIScrollView,他提供了更深层的封装。同UIPageViewController一样，非常适合本作为本组件的基类。同时，当UICollectionView的一些代理方法不足以提供相关信息时，还可以通过UIScrollView的代理方法来解决。&lt;/p&gt;
&lt;p&gt;采用&lt;code&gt;UIPageViewController&lt;/code&gt;作为子类，考虑到使用者需要将其作为subViewController添加到它们的项目中，没有将一个View添加到ViewController中来得直观，综合考虑，PSCarouselView选择了UICollectionView作为其基类。&lt;/p&gt;
&lt;h3&gt;实现功能&lt;/h3&gt;&lt;p&gt;如何利用UICollectionView在有限的图片数量下实现无限轮播？只需在原有图片数组头尾各新增一张图片就可以实现。如图&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/11/----001.jpeg&quot;/&gt;&lt;/p&gt;
&lt;p&gt;将imageURL数组中的URL,扩充为N+2。同时，将imageURLs的最后一个URL作为新数组的第一个URL,将imageURLs的第一个URL作为新数组的最后一个URL。然后在我们的CollectionView滚动到最后一个Cell时，跳转到第二个URL表示的IndexPath即可。自动轮播采用计时器来完成。在实现的时候，我们需要注意一下的几点&lt;/p&gt;
&lt;p&gt;1.计时器的开启与暂停&lt;/p&gt;
&lt;p&gt;自动轮播，通常我们会使用到计时器NSTimer。当我们在页面切换的过程中，需要注意计时器的开启与暂停，不然可能会出现一些不可预料的BUG。PSCarouselView 作为一个 &lt;code&gt;View&lt;/code&gt; 是不可能也不应该知道一个 &lt;code&gt;ViewController&lt;/code&gt; 的生命周期的。因此我们需要提供两个接口，供使用者开启/暂停计时器。&lt;/p&gt;
&lt;pre class=&quot;legacy-code&quot;&gt;&lt;code&gt;- (void)startMoving;
- (void)stopMoving;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;另外，我们还需要注意App的生命周期，当App进入不活动的状态时，我们也需要将计时器暂停，并在回到活动状态时相应地启动。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;#pragma mark - Notification
//程序被暂停的时候，应该停止计时器
- (void)applicationWillResignActive
{
    [self stopMoving];
}

//程序从暂停状态回归的时候，重新启动计时器
- (void)applicationDidBecomeActive
{
    if (self.isAutoMoving)
    {
        [self startMoving];
    }
}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;2.用户操作与自动轮播的冲突&lt;br/&gt;用户操作时如果轮播还是继续滚动，会导致用户产生不可控的错觉。《iOS Human Interface Guide》中强调过App需要给于用户控制感。因此，在用户手动”翻页”的时候，我们需要暂时暂停一下自动轮播，并在用户手动”翻页”完成后，重新进行轮播。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;//用户手动拖拽，暂停一下自动轮播
- (void)scrollViewWillBeginDragging:(UIScrollView     *)scrollView
{
    [self removeTimer];
}

//用户拖拽完成，恢复自动轮播（如果需要的话）
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView
{
    if (self.isAutoMoving)
    {
        [self addTimer];
    }
}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;3.图片的缓存与展示&lt;br/&gt;如何通过图片的URL来获得相对应的图片，并做好图片的缓存，以实现最大限度地节省流量？这个模块其实应该单独做一个有关图片缓存的库，而不应该包含到View层中来。本作采用了SDWebImage来实现这一功能。有兴趣的朋友可以尝试着实现一个图片缓存库。&lt;/p&gt;
&lt;p&gt;以上，一个轮播组件的封装基本上完成了。更多实现上的细节请参看GitHub上的&lt;a href=&quot;https://github.com/DeveloperPans/PSCarouselView&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Demo&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;That’s all.Hope you enjoy it :)&lt;/p&gt;</content:encoded></item><item><title>iOS项目架构 - 统一行为</title><link>https://www.shengpan.net/blog/basevc/</link><guid isPermaLink="true">https://www.shengpan.net/blog/basevc/</guid><description>“我们虽然在构造软件，但软件也会重新塑造我们”。在写 iOS项目架构-模块化 的时候，我仍然觉得我所构建的统一行为方式还算不错，可以写出来与大家探讨探讨。昨日将应用发布的闲暇之余阅读了 objc中国的这篇文章 ，令我明白尚有更优的解决方案。本文从实际</description><pubDate>Wed, 14 Oct 2015 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;“我们虽然在构造软件，但软件也会重新塑造我们”。在写&lt;a href=&quot;http://shengpan.coding.io/architecture-module/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;iOS项目架构-模块化&lt;/a&gt;的时候，我仍然觉得我所构建的统一行为方式还算不错，可以写出来与大家探讨探讨。昨日将应用发布的闲暇之余阅读了&lt;a href=&quot;http://objccn.io/issue-13-4/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;objc中国的这篇文章&lt;/a&gt;，令我明白尚有更优的解决方案。本文从实际的例子出发，发表一下我的拙见，用以和上文做对照，权当抛砖引玉。&lt;/p&gt;
&lt;h3&gt;BaseViewController&lt;/h3&gt;
&lt;h4&gt;例子1&lt;/h4&gt;&lt;p&gt;我们在构建一个App的时候，会有许多相同的行为。例如，任何需要网络请求的界面，总会需要一个indicator来告诉用户，“噢，我正在操作，请等我一下”。或者某个时候我们需要给用户一点小提示，来对他们的操作进行反馈等等。每一个ViewController都会有这样的行为。这是我们很直接地想到&lt;strong&gt;我们需要一个父类&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;于是我们新建一个基类，&lt;code&gt;BaseViewController&lt;/code&gt;继承于&lt;code&gt;UIViewController&lt;/code&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@interface BaseViewController : UIViewController
/**
 *  a little pop window used to replace laertView
 *
 *  @param tips tips will show to user
 */
- (void)showTips:(NSString *)tips;

/**
 *  When some operation need user waiting,use this method to show a HDU.
 *
 *  @param title will show to user
 */
- (void)showIndicatorWithTitle:(NSString *)title;

- (void)hideIndicator;
@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;好了，现在我们所有的业务相关ViewController都继承自BaseViewController，并且在调用网络请求前轻松地写一句&lt;code&gt;[self showIndicatorWithTitle:@&quot;加载中...&quot;]&lt;/code&gt;，并且在网络请求完成后的回调里写下&lt;code&gt;[self hideIndicator]&lt;/code&gt;就可以轻松地完成指示器的显示隐藏了。感谢我们的继承！&lt;/p&gt;
&lt;h4&gt;例子2&lt;/h4&gt;&lt;p&gt;再举个例子。在我的项目里访问服务器的时候需要Token，Token在某些情况下有可能过期。Token过期的时候会返回一个Token过期的状态码，此时需要用户重新登录。这个情况我们可以总结成：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;绝大多数ViewController都会发送网络请求&lt;/li&gt;
&lt;li&gt;每一个网络请求都会返回Token过期&lt;/li&gt;
&lt;li&gt;每个ViewController都需要处理Token过期的情况&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;因此我们可以将这一行为抽取出来，写在BaseViewController中。这样只需要在各个业务模块的的Model层收到Token过期消息的时候，用Notification转发给BaseViewController就可以了。其他诸如网络请求失败等情况都是如此。&lt;/p&gt;
&lt;p&gt;每个项目有不同的统一行为，我们需要根据不同的行为抽取不同的基类。&lt;/p&gt;
&lt;h3&gt;使用协议&lt;/h3&gt;&lt;p&gt;但是有一种情况。例如&lt;code&gt;LoginViewController&lt;/code&gt;需要和&lt;code&gt;BaseViewController&lt;/code&gt;一样的显示/隐藏Indicator的接口，但却没有其他相同的行为。这时继承就显得不太合适了。&lt;/p&gt;
&lt;p&gt;想象一下&lt;code&gt;BaseViewController&lt;/code&gt;因为Token过期Present了&lt;code&gt;LoginViewController&lt;/code&gt;,而&lt;code&gt;LoginViewController&lt;/code&gt;因为继承了&lt;code&gt;BaseViewController&lt;/code&gt;又不停地Present另一个&lt;code&gt;LoginViewController&lt;/code&gt;…这时候如果使用继承的话，就不得不写一些脏代码来避免这样的情况。&lt;/p&gt;
&lt;p&gt;正如那篇文章所说，此时我们可以用协议&lt;code&gt;@protocol&lt;/code&gt;来替代继承。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@protocol PSIndicator &amp;lt;NSObject&amp;gt;

- (void)showTips:(NSString *)tips;
- (void)showIndicatorWithTitle:(NSString *)title;
- (void)hideIndicator;

@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后在&lt;code&gt;LoginViewController&lt;/code&gt;中：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@interface LoginViewController : UIViewController&amp;lt;PSIndicator&amp;gt;

@end
&lt;/code&gt;&lt;/pre&gt;&lt;h3&gt;最后&lt;/h3&gt;&lt;p&gt;如果你在读这篇文章的时候想到，网络请求相关的内容为什么不直接封装在网络操作相关的模块，由它来负责指示器的显示和隐藏。这样还能省去手动调用的麻烦。关于这一点，在&lt;a href=&quot;http://shengpan.coding.io/architecture-module/&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这篇文章&lt;/a&gt;里已经做了讨论。&lt;/p&gt;</content:encoded></item><item><title>漫谈iOS中的MVC</title><link>https://www.shengpan.net/blog/man-tan-ioszhong-de-mvc/</link><guid isPermaLink="true">https://www.shengpan.net/blog/man-tan-ioszhong-de-mvc/</guid><description>做过一段iOS开发的开发者们对MVC肯定不陌生。这是 Apple推荐 的开发iOS应用程序的标准设计模式。</description><pubDate>Wed, 14 Oct 2015 00:00:00 GMT</pubDate><content:encoded>&lt;h3&gt;前言&lt;/h3&gt;
&lt;p&gt;做过一段iOS开发的开发者们对MVC肯定不陌生。这是&lt;a href=&quot;https://developer.apple.com/library/ios/documentation/General/Conceptual/DevPedia-CocoaCore/MVC.html&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;Apple推荐&lt;/a&gt;的开发iOS应用程序的标准设计模式。&lt;/p&gt;
&lt;p&gt;我们从一张图开始，谈谈MVC。&lt;/p&gt;
&lt;h3&gt;MVC&lt;/h3&gt;&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/10/MVC.png&quot;/&gt;&lt;br/&gt;传统的MVC如上图。将不同的对象划分到三个阵营&lt;code&gt;Model&lt;/code&gt;、&lt;code&gt;View&lt;/code&gt;、&lt;code&gt;Controller&lt;/code&gt;。View负责绘图、接收用户的交互，并将交互以&lt;em&gt;Blind&lt;/em&gt;的方式传达到Controller。Controller则负责处理相对应的业务逻辑，并告诉Model更新数据。Model则负责更新数据，并将数据以Blind的方式交给View或者Controller。在传统的MVC中C同时知晓V和M两者的状态和所有信息。&lt;strong&gt;View也知晓Model的信息&lt;/strong&gt;，但Model是不知道其他两者的任何信息的。&lt;/p&gt;
&lt;p&gt;这种设计在JavaWeb的开发中被广泛使用。因为View层的页面布局，响应，由js和css完成，jsp此时可以直接拿Model解析数据。。在这种情况下，View和Controller的任务最重，Model更像是一个有数据查询功能的Entity。&lt;/p&gt;
&lt;h3&gt;iOS中的MVC&lt;/h3&gt;
&lt;p&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/10/StandfordMVC.png&quot;/&gt;&lt;br/&gt;iOS中的MVC和传统的MVC大同小异，小异的地方是对传统MVC的改进。&lt;/p&gt;
&lt;p&gt;首先是&lt;strong&gt;View&lt;/strong&gt;层。View依然负责着接收用户交互和图像的绘制，但是，&lt;strong&gt;View不再直接处理数据了&lt;/strong&gt;。而是将数据相关的实现逻辑用协议的形式，交给其他对象（一般是ViewContorller），由这个对象告诉View，View应该如何展现。苹果的TableView、PickerView等View的设计很好地印证了这一点。此时View变成了纯粹的”View”，一个”Data Independent”的View，复用性无疑是非常高的。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Model&lt;/strong&gt;在iOS中也扮演着与Web开发中相同的角色。常常被开发者们误当成Entity使用。它负责持有数据，并且有少量的逻辑。在这样的设计下，Model其实是非常瘦的。&lt;/p&gt;
&lt;p&gt;在iOS中，Model和View是相互分离的，既不相互拥有，也相互不交互，即时是以Blind的模式。当Model有所变化时，常常通过KVO或者Notification的方式通知Controller，而不是View。因此，即时有的时候View中会有Notification的监听者，但也绝对不会是Model发出的Notification的监听者。更何况是，我们在实际开发中，Controller有各种方式来告诉View，你应该显示什么，所以View与Model是可以绝对隔离开的。&lt;/p&gt;
&lt;p&gt;最后是&lt;strong&gt;Controller&lt;/strong&gt;。Controller在iOS中被命名为ViewController。从命名就可以看出Controller和View的关系非常密切，它直接拥有View，负责着View的创建，显示，隐藏等等。View的代理，数据源，用户交互的响应，也都由Controller负责。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;Controller&lt;/code&gt;&lt;strong&gt;拥有&lt;/strong&gt;&lt;code&gt;View和Model&lt;/code&gt;。知晓他们二者的一切情况，负责将Model的数据解释给View，负责根据View中的用户交互让Model处理数据并让View做出相对应的反馈。并且Controller也负责接收Model发出的Notification，在Model状态改变时，及时让View做出相对应的变化。&lt;/p&gt;
&lt;p&gt;Controller在iOS开发中扮演了重量级的角色。的在实际的开发过程中，有80%的时间是在ViewController上面做文章。这也直接导致了一些问题…&lt;/p&gt;
&lt;h3&gt;臃肿的Controller&lt;/h3&gt;
&lt;p&gt;在以上的MVC中，Model其实大多和业务相关，所以Apple的API设计并没有对这一层有所体现。Apple将诸如&lt;code&gt;didReceiveMemoryWarning&lt;/code&gt;的方法都放在了ViewController里面，这让我们有种ViewController什么都可以干的直觉。&lt;br/&gt;生命周期管理、依照View的需求将数据格式化，View的初始化及组织,各种Delegate，界面的跳转等等都在Controller中完成。&lt;/p&gt;
&lt;p&gt;正是由于Controller扮演了太过重要的角色。导致Controller在编程过程中变得越来越臃肿。其中的代码动辄上千行。有些其他模块也需要的可以复用的代码只能通过复制黏贴的方式。一旦业务和需求有所修改，就得在混合了各种逻辑的Controller的一堆代码中上下翻找。这对像我一样喜欢偷懒的开发者来说就是噩梦。&lt;/p&gt;
&lt;h3&gt;网络请求放哪儿&lt;/h3&gt;&lt;p&gt;在以上的MVC分类中，并没有涉及到网络请求。而网络请求几乎是每一个App必须的。那么，网络请求应该归类到哪边？稍微思考一下，觉得放在Model里会不错。但是网络请求是异步的，如果网络请求还没返回，Model的生命周期却结束了，那可不是一件好事。当然，肯定不会把请求放在View里…所以，最后网络请求还是放到了Controller中。在与我共事的许多有经验的iOS开发者都是这么选择的。但是，这又加剧了Controller的臃肿。&lt;/p&gt;
&lt;h3&gt;为Contrller瘦身&lt;/h3&gt;&lt;p&gt;So，怎么样优化这一结构呢。首先想到的是，把网络请求先移出来。如果解决了Model的生命周期和网络请求的生命周期问题，网络请求相关的代码就可以放在Model里。前面把网络请求放在ViewController里，那么只要保持Model和ViewController的生命周期一致，就可以将网络请求移动到Model里了。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Bingo，让Model成为ViewController的一个Strong属性。&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@interface ShopListController ()
@property (strong, nonatomic) ShopListModel *model;
@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这个时候Model里可以尽情访问网络请求了。因为Model和ViewController生命周期一直，也不必再担心网络请求着陆点丢失的问题。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@interface ShopListModel : BaseModel
- (void)fetchShopListData;
@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;那么数据的存储和格式化也自然而然地在Model中处理了。同时我们还可以把数据持久化，一些类似于验证用户输入等等与UI不相关的数据处理和计算，都可以放在Model里。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@interface ShopListModel : BaseModel
@property (strong, nonatomic) NSMutableArray *dataSource;
- (void)fetchShopListData;
@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;最后我们在model中网络请求完成的回调里，处理好相关数据整理成包含UI直接可用对象的DataSource，并发送相对应的Notification来通知ViewController对View进行更新。&lt;/p&gt;
&lt;p&gt;Model实现：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@implementation ShopListModel
- (void)fetchShopListData
{
    ...
    ...
    [[NSNotificationCenter defaultCenter] postNotificationName:FETCH_SHOP_LIST_DATA_NOTIFICATION object:nil];
    ...
    ...
}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;ViewController实现：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;- (void)viewDidLoad
{
    [super viewDidLoad];
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(didReceiveModelNotification:)
                                                 name:FETCH_SHOP_LIST_DATA_NOTIFICATION
                                               object:nil];

}

- (void)didReceiveModelNotification:(NSNotification *)notification
{
    if ([notification.name isEqualToString:FETCH_SHOP_LIST_DATA_NOTIFICATION])
    {
        [self.tableView reloadData];
        return;
    }
}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;此时我们得到了一个功能丰富的且易于复用的Model。如果别的界面也需要相同的数据，我们只需要将这个Model给另一个Controller使用，并注册相对应的Notification监听即可。&lt;/p&gt;
&lt;h3&gt;MVC进化版——MVCE&lt;/h3&gt;&lt;p&gt;其实我们做的这一系列事情，无非是不断地将代码分离。力求做到一种”原子性”。最终最求的目标就是更高的可维护性、可拓展性和复用性。以这种思维反观上面的MVC，Controller已经变得相对较瘦，但随之而来的是Model又胖了起来。&lt;/p&gt;
&lt;p&gt;于是就有人提出了&lt;strong&gt;MVCS&lt;/strong&gt;的模式。&lt;strong&gt;S&lt;/strong&gt;即&lt;strong&gt;Store&lt;/strong&gt;。将网络请求与数据持久化相关的操作，分到Store模块中去。&lt;/p&gt;
&lt;p&gt;借鉴微软的&lt;strong&gt;MVVM&lt;/strong&gt;，应用到iOS中的&lt;strong&gt;ReactiveCocoa&lt;/strong&gt;，考虑到View与Controller的紧密联系，将View和ViewController直接划分为View。开辟出一个ViewModel来解决上述问题。在MVVM里，你可以把输入验证，网络请求，数据持久化都放在ViewModel里，Model仍然是Model，不与View直接交互。&lt;/p&gt;
&lt;p&gt;其实以上的设计模式，都脱不开MVC的影子，只是在实践中不断借鉴，不断优化。包括我想到的这些解决方案。在了解过MVVM设计模式后，这套解决方案还真颇有点MVVM的味道。在我的解决方案里，Model差不多等于MVVM中的ViewModel，而MVVM中的Model在这边等同于Entity。嗯。。于是我打算给它取个名字叫——MVCE。哈哈。。开个玩笑。（为了下文方便，暂且称为MVCE）。&lt;/p&gt;
&lt;h3&gt;留下的思考&lt;/h3&gt;&lt;p&gt;设计模式这么多，该如何选择？&lt;/p&gt;
&lt;p&gt;在实战中，不一定非要抓住某个模式不放，更重要的是理解模式背后的意义，并且灵活运用。比如说在MVCE中，ViewController中还剩下什么呢？生命周期，Delegate，界面跳转，Notification响应。有这么一种情况：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;有时候有几个TableView高度相似，想要复用之前ViewController中的代理。
一般来说，我们复制黏贴相关代理方法到另一个ViewController中，并稍微修改一下不同的地方。
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上情况其实可以抽象出一个Adapter，专门放TableView的代理，这样在ViewController中，只需要Import这个Adapter，稍微修改Adapter的一些属性，而不需要一遍遍地复制黏贴代理代码。&lt;/p&gt;
&lt;p&gt;当然，这样做的后果，牺牲了少部分原有代理的灵活性——我们可以在ViewController中任意定义TableView，切我们的代码中又多出了一个Adapter类。但好处是，封装性更好了，复用性更好了。&lt;/p&gt;
&lt;p&gt;##最后&lt;br/&gt;返璞归真，所有的设计模式，都是为了更好地解决问题存在的。每个系统有每个系统固有的复杂度，当设计模式将其细分到一定程度，所做的事情只不过是将复杂度的位置挪了挪。所以，我们要了解设计模式，更要在合理的地方，合理地利用设计模式。诸如App中的关于页面，信息量少，逻辑少。所有逻辑直接放在ViewController里，也不会超过100行代码，那就放吧。&lt;/p&gt;</content:encoded></item><item><title>iOS项目架构 - 模块化</title><link>https://www.shengpan.net/blog/module/</link><guid isPermaLink="true">https://www.shengpan.net/blog/module/</guid><description>本文主要就以上模块化，以网络请求模块的抽取为例稍作讨论。</description><pubDate>Wed, 14 Oct 2015 00:00:00 GMT</pubDate><content:encoded>&lt;h3&gt;当我们谈论iOS架构的时候我们在谈论什么&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;模块化&lt;/li&gt;
&lt;li&gt;规范化&lt;/li&gt;
&lt;li&gt;统一行为&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;本文主要就以上模块化，以网络请求模块的抽取为例稍作讨论。&lt;/p&gt;
&lt;h3&gt;模块化&lt;/h3&gt;&lt;p&gt;模块化的目的是实现解耦，提升模块、组件的复用性。一个很简单的例子，App需要与服务器交换数据，最差的做法，是把网络请求、回调、业务处理、界面操作全部写在&lt;code&gt;ViewController&lt;/code&gt;里。如果把网络请求抽取出来，建一个&lt;code&gt;Webservice&lt;/code&gt;类，仅负责最基本的RESTful请求，并在回调中处理好类似404，无网络等各种网络状况。那么，这个类就变成了通用的网络服务处理模块，便于维护和复用。&lt;/p&gt;
&lt;h3&gt;遇到的问题&lt;/h3&gt;&lt;p&gt;在划分模块的一个前提是，模块不要对其他层有依赖性。最好的情况是，这个模块拿到任意一个项目都可以直接使用。在这一点上，我遇到了一个值得思考的问题。&lt;/p&gt;
&lt;p&gt;在iOS客户端里，网络请求可以分为两种，一种是&lt;strong&gt;静默请求&lt;/strong&gt;,也就是在用户不知情的情况下默默地进行网络请求处理。典型的例子有微信朋友圈点赞。用户在点赞时，UI直接进行点赞成功的反馈，同时网络请求在静默进行，不阻碍用户的正常操作。另一种是&lt;strong&gt;显示请求&lt;/strong&gt;，用户需等待操作完成后才能进行下一步操作。典型的例子一种是下拉刷新，另一种是支付宝付款。付款的请求中，UI暂时显示一个Loading图标，用以提示用户程序正在处理，而非卡死（设计思想：&lt;strong&gt;反馈&lt;/strong&gt; ——&lt;a href=&quot;http://zhuanlan.zhihu.com/langqixu/19675089&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;《iOS Human Interface Guidelines》&lt;/a&gt;）。&lt;/p&gt;
&lt;p&gt;遇到的选择，是在第二种&lt;strong&gt;显示请求&lt;/strong&gt;的情况下如何更好地封装。我所负责的这个项目，除网络请求外，并没有耗时很长的I/O等情况需要处理。因此，有两个方案。&lt;/p&gt;
&lt;p&gt;将UI的Loading封装在WebService中，仅暴露&lt;code&gt;isShowIndicator&lt;/code&gt;和&lt;code&gt;toView&lt;/code&gt;两个参数在网络请求的接口中&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;- (void)requestWithPath:(NSString *)path
             parameters:(id)parameters
        isShowIndicator:(BOOL) isShowIndicator
                  toView:(UIView *)toView
               labelText:(NSString *)labelText
                 success:(SuccessBlock)success
                 failure:(FailureBlock)failure;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;或者，将UI的Loading封装在BaseViewController中，作为一个ViewController的基础行为，相应的业务模块需要显示请求时，调用显示指示器方法。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;@interface BaseViewController : UIViewController

- (void)showTips:(NSString *)tips;
- (void)showIndicatorWithTitle:(NSString *)title;
- (void)hideIndicator;

@end
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;前一种方式在写具体的业务逻辑时非常方便。只需要在调用前考虑一下这个请求是否为静默请求，然后将&lt;code&gt;BOOL&lt;/code&gt;和&lt;code&gt;View&lt;/code&gt;参数传入此方法中即可。这样封装的==好处==是，可以在网络层的回调中，处理好指示器的隐藏，以免出现忘记调用Hide方法的情况，并且&lt;code&gt;ViewController&lt;/code&gt;不必因为需要这两个方法，就继承&lt;code&gt;BaseViewController&lt;/code&gt; 。==缺点==是不够灵活，如果有不同的业务需要处理不同的显示，隐藏方式，还是需要在&lt;code&gt;ViewController&lt;/code&gt;中重新写一下。&lt;/p&gt;
&lt;p&gt;后一种方式在写具体的业务时==缺点==是略微麻烦一些，需要考虑好相对应业务具体情况，具体调用显示隐藏指示器，优点是灵活，&lt;strong&gt;并且做到了网络层的去UI依赖&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;就MVC模式来说，&lt;code&gt;UI&lt;/code&gt;响应数据的处理，应当由&lt;code&gt;Controller&lt;/code&gt;负责调度。苹果自己在设计的时候，也都遵循了这一设计模式。&lt;code&gt;WebService&lt;/code&gt;层，可以算作&lt;code&gt;Model&lt;/code&gt;层的一个工具。而&lt;code&gt;Model&lt;/code&gt;层与&lt;code&gt;View&lt;/code&gt;层，在iOS的设计上是&lt;strong&gt;绝对不允许直接交互&lt;/strong&gt;的。引用一张斯坦福大学iOS7公开课上的图来形象地展示一下。&lt;br/&gt;&lt;img alt=&quot;文章配图&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/10/stanford.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;Model和View之间是双黄线，就像开车一样，绝对不能压过双黄线 ：）至于为什么，我们以后讨论到MVC设计模式再详细讨论。&lt;/p&gt;
&lt;p&gt;因此，在WebService中封装了View，实际上是在Model层操作View。多了这么一个View，多出来的事可就多了。我们不仅需要Import进UIKit，还需要Import通用的Indicator。这一依赖就产生了模块之间的依赖，原本为了解耦合而提取的WebService层反而耦合了Indicator。同时，也造成Webservice的粒度增大。需要处理的事情变得更多。&lt;/p&gt;
&lt;p&gt;反观第二种方法，需要所有ViewController继承BaseViewController。继承本身是紧耦合的。然而纵向的紧耦合有时候减少了重复工作，将一些相同的行为，做统一化的处理，并且没有造成横向跨层的依赖。类似于无网络时的处理，网络请求出错时的处理，Token过期的处理，都应该放在BaseViewController里面。因为这是所有Controller都需要面对的问题。因此，继承BaseViewController是必要的。在统一行为之余，把这几个方法封装在BaseViewController中，又让WebService层实现了细颗粒的模块化组件化。同时，Controller本身就需要控制View，不会因此Import进许多不相关的模块。所需要付出的仅仅是在网络请求结束的时候别忘记调用Hide方法，不然测试小妹的“界面失去响应”BUG就会指派到我们头上 ：（&lt;/p&gt;
&lt;p&gt;最终，我们的Webservice是封装成这样的：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;/**
 *  post a request to server
 *
 *  @param path       the request path append at BASEURL
 *  @param parameters parameters
 *  @param token      Authorization token
 *  @param success    when success goto this block
 *  @param failure    when failure goto this block
 */    
- (void)postWithPath:(NSString *)path
     parameters:(NSDictionary *)parameters
          token:(NSString *)token
        success:(void (^)(id JSON))success
        failure:(void (^)(NSError *error, id JSON))failure;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;综上所述，模块化所需要遵循的思想就是：轻，少，专。其实思想和我们写方法的时候考虑的“一个方法只做一件事”有类似的地方。&lt;/p&gt;
&lt;p&gt;That’s all，hope you enjoy it ：）&lt;/p&gt;</content:encoded></item><item><title>iOS项目架构 - 规范</title><link>https://www.shengpan.net/blog/standard/</link><guid isPermaLink="true">https://www.shengpan.net/blog/standard/</guid><description>记得刚工作的时候，我的Mentor带我参加某银行业务系统研发成果交流分享会。会议让我印象很深的一点，是关于规范。发言人在说规范的时候，举了他见过的这么一个例子：</description><pubDate>Wed, 14 Oct 2015 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;记得刚工作的时候，我的Mentor带我参加某银行业务系统研发成果交流分享会。会议让我印象很深的一点，是关于规范。发言人在说规范的时候，举了他见过的这么一个例子：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;&amp;lt;div class=&quot;div1&quot; ...&amp;gt;
  &amp;lt;div class=&quot;div2&quot; ...&amp;gt;
    &amp;lt;div class=&quot;div3&quot; ...&amp;gt;
     ...
    &amp;lt;/div&amp;gt;
  &amp;lt;/div&amp;gt;
&amp;lt;/div&amp;gt;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;“只有鬼才知道他的div1是什么！”&lt;/p&gt;
&lt;p&gt;没有规范的代码，增加了代码的阅读成本，也因此大大降低了团队合作的效率。当产品上线后，出了BUG需要修复，而负责维护的却不是当初的开发团队，这是看混乱的代码成了一个噩梦。我们不只一次地听别的程序猿哀嚎过：“嗷，又要看别人的代码”。不规范的代码也是一方面的成因。&lt;/p&gt;
&lt;p&gt;为了提高生产效率，同时也是本着对自己产出的代码，以及对他人负责的理念，在公司内部（如果客观条件做不到，至少在团队内部）需要践行代码的规范。一般来说，各司有各司的代码规范，基本的代码规范在此就不赘述了。然而，有一些&lt;strong&gt;原则&lt;/strong&gt;是通用的，在此略作梳理：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. 首先是为人编写程序，其次才是计算机。&lt;/strong&gt;&lt;br/&gt;软件的生命周期贯穿产品的开发，测试，生产，用户使用，版本升级和后期维护等过程，只有易读，易维护的软件代码才具有生命力。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 保持代码的简明清晰，避免过分的编程技巧。&lt;/strong&gt;&lt;br/&gt;简单是最美。不要过分追求技巧，否则会降低程序的可读性。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. 编程时首先达到正确性，其次考虑效率。&lt;/strong&gt;&lt;br/&gt;编程首先考虑的是满足正确性，健壮性，可维护性，可移植性等质量因素。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;4. 编写代码时需要考虑到代码的可测试性。&lt;/strong&gt;&lt;br/&gt;不可以测试的代码是无法保障质量的。实现设计功能的同时，要提供可以测试、验证的方法。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;5. 函数（方法）是为一特定功能而编写，不是万能工具箱。&lt;/strong&gt;&lt;br/&gt;方法是一个处理单元，是由特定功能的，所以应该很好地规划方法，不能是所有东西都放在一个方法里实现&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;6. 鼓励多注释。&lt;/strong&gt;&lt;/p&gt;
&lt;h3&gt;一些较为实用的iOS规范小Tips&lt;/h3&gt;&lt;p&gt;在项目实战中，我总结出了一些比较实用的小点，在此分享一下，希望对大家有所帮助。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1.所创建项目的文件夹目录结构和Xcode中的虚拟Group文件夹的结构须一致，便于代码文件的维护。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;规范的文件目录结构如下：&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文件夹结构&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/10/standard-floder.jpg&quot;/&gt;&lt;/p&gt;
&lt;p&gt;推荐划分文件夹的时候按功能模块划分，便于修改BUG的时候寻找。&lt;/p&gt;
&lt;p&gt;不规范的文件夹目录结构如下：&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;不规范的文件夹结构&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;/content/images/2015/10/floder.jpg&quot;/&gt;&lt;/p&gt;
&lt;p&gt;资源文件、源码文件、第三方库全部混合放置，每个文件引用次数未知，稍微移动便会造成引用错误编译失败，都是因为文件夹目录结构不规范T T。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 胖Model瘦Controller。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;大部分业务逻辑放在Model中做，Controller只负责Model和View的调配。Model和View不可直接沟通。Model-&amp;gt;Controller，使用NSNotification传递消息。View-&amp;gt;Controller采用Targt-action或者Delegate传递消息。&lt;em&gt;ViewController终于从上千行代码的困境中解放出来了！&lt;/em&gt; &lt;/p&gt;
&lt;p&gt;&lt;strong&gt;这条规范&lt;/strong&gt;的&lt;strong&gt;为什么&lt;/strong&gt;我们会在MVC的文章中详细讨论。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3.标注方法块&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;同类方法写在一起，并用&lt;code&gt;#pragma mark&lt;/code&gt;做标注。一个.m文件的方法至上而下应该是这样的：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;#pragma mark - Life cycle

- (void)viewDidLoad {...}
- (void)viewWillAppear:(BOOL)animated {...}

#pragma mark - Private Method

-(void)setContentofScrollView {...}

#pragma mark - Notification

- (void)userDidLogin:(NSNotification *)notification {...}
- (void)mainViewPicsDownloaded:(NSNotification *)notification {...}

#pragma mark - UIScrollViewDelegate

- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView {...}
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {...}

#pragma mark - Navigation

- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {...}

#pragma mark - Getter and Setter

- (MainViewModel *)model{...}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;在标注&lt;code&gt;Delegate&lt;/code&gt;的时候，把Delegate名称直接做作为标注，比如&lt;code&gt;UITableViewDelegate&lt;/code&gt;,&lt;code&gt;UITableViewDataSource&lt;/code&gt;。这样的好处是，当这个Delegate是自定义的时候，别人在看代码的时候可以直接&lt;em&gt;command+左键&lt;/em&gt;点击跳转到Delegate，便于他人阅读和寻找自定的Delegate。&lt;/p&gt;
&lt;p&gt;Getter 和 Setter放在最后。&lt;/p&gt;
&lt;p&gt;另外，尽可能地减少Controller中的私有方法。私有方法大多可以在Model中实现。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;4.所有属性都使用Getter and Setter&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;不要在&lt;code&gt;viewDidLoad&lt;/code&gt;里面初始化view然后再add，这样代码就很难看。在&lt;code&gt;viewDidload&lt;/code&gt;里面只做&lt;code&gt;addSubview&lt;/code&gt;的事情，然后在&lt;code&gt;viewWillAppear&lt;/code&gt;里面做布局的事情，&lt;del&gt;最后在&lt;code&gt;viewDidAppear&lt;/code&gt;里面做&lt;code&gt;Notification&lt;/code&gt;的监听之类的事情&lt;/del&gt;&lt;em&gt;监听也同时放在&lt;code&gt;ViewWillAppear&lt;/code&gt;中，在某些特殊的情况下，在&lt;code&gt;ViewDidAppear&lt;/code&gt;中注册的监听会导致无法&lt;code&gt;removeObserver&lt;/code&gt;&lt;/em&gt;。至于属性的初始化，则交给getter去做。&lt;/p&gt;
&lt;p&gt;不要：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;- (void)viewDidLoad
{
   [super viewDidLoad];
   self.textLabel = [[UILabel alloc] init];
   self.textLabel.textColor = [UIColor blackColor];
   self.textLabel ... ...
   self.textLabel ... ...
   self.textLabel ... ...
   [self.view addSubview:self.textLabel];
}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;而是：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;- (UILabel *)textLabel
{
    if (!_textLabel)
    {
        _textLabel = [[UILabel alloc] init];
        _textLabel.textColor = [UIColor blackColor];
        _textLabel ... ...
        _textLabel ... ...
        _textLabel ... ...
    }
    return _textLabel;
}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;5.注释你的公有方法&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;使用&lt;a href=&quot;https://github.com/onevcat/VVDocumenter-Xcode/archive/master.zip&quot; rel=&quot;noopener noreferrer&quot; target=&quot;_blank&quot;&gt;这个工具&lt;/a&gt;规范注释.h头文件中的属性和方法。十分直白的方法和属性可以不注释。&lt;/p&gt;
&lt;p&gt;That’s all.Hope u enjoy it. : )&lt;/p&gt;</content:encoded></item><item><title>iOS的多Target应用</title><link>https://www.shengpan.net/blog/iosmultitarget/</link><guid isPermaLink="true">https://www.shengpan.net/blog/iosmultitarget/</guid><description>最近刚完成了一个多Target的项目，做了许多思考与选择，现写下心得总结，权当抛砖引玉。</description><pubDate>Wed, 16 Sep 2015 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;最近刚完成了一个多Target的项目，做了许多思考与选择，现写下心得总结，权当抛砖引玉。&lt;/p&gt;
&lt;h4&gt;项目背景&lt;/h4&gt;&lt;p&gt;本项目是一个适用于正在学车人群的预约学车平台。分为学生端和教练端。学生端主功能为预约学车，教练端主功能为排课。&lt;/p&gt;
&lt;h3 id=&quot;什么时候选用多Target&quot;&gt;&lt;a class=&quot;headerlink&quot; href=&quot;#什么时候选用多Target&quot; title=&quot;什么时候选用多Target&quot;&gt;&lt;/a&gt;什么时候选用多Target&lt;/h3&gt;&lt;p&gt;多target的选用，意在实现最大化重用代码。其经典情景是有多个类似的App，界面设计与业务逻辑有许多相似之处，仅仅有少数不同的业务逻辑，只需要在打包时将不同的配置文件打包好，就可以形成一个个不同的客户端。&lt;/p&gt;
&lt;p&gt;我负责两个客户端有以下共同点：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;近乎相同的登陆注册界面与逻辑&lt;/li&gt;
&lt;li&gt;近乎相同的主页布局与逻辑&lt;/li&gt;
&lt;li&gt;近乎相同的个人中心主界面&lt;/li&gt;
&lt;li&gt;近乎相同的课表界面&lt;/li&gt;
&lt;li&gt;近乎相同的选课/排课界面&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;不同点有：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;不同的应用主题色&lt;/li&gt;
&lt;li&gt;排课与选课的逻辑不同&lt;/li&gt;
&lt;li&gt;一些图标资源和其他细节的不同&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;本项目选择多Target方案是十分合适的。&lt;/p&gt;
&lt;h3&gt;为多Target打基础&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;编写共用的层（&lt;code&gt;WebService&lt;/code&gt;，&lt;code&gt;Common&lt;/code&gt;等）&lt;/li&gt;
&lt;li&gt;抽取基类(&lt;code&gt;BaseViewController&lt;/code&gt;,&lt;code&gt;BaseModel&lt;/code&gt;,&lt;code&gt;BaseView&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;编写子模块，利用MVC模式保持单个子模块的独立性，并预留相对应的差异化枚举和接口。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;项目的结构是这样的&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;文件结构&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;https://coding.net/u/Shengpan/p/Ghost-On-Coding-Paas/git/raw/master/images/filestruct.png&quot;/&gt; &lt;/p&gt;
&lt;p&gt;网络层不使用单例，而是采用了&lt;code&gt;Category&lt;/code&gt;的模式。&lt;strong&gt;只将最基本的&lt;code&gt;RESTful&lt;/code&gt;请求封装好放在&lt;code&gt;WebService&lt;/code&gt;中。&lt;/strong&gt;而具体的实现采用&lt;code&gt;Category&lt;/code&gt;拓展方法。这样的好处是&lt;strong&gt;各自的WebService有各自的生命周期，每个Webservice可以只负责自己模块的网络层服务。&lt;/strong&gt;比如说在这个项目中我分了Account，Teacher，Student等Category，分别负责登陆注册，教练端和学生端的网络请求服务。&lt;/p&gt;
&lt;p&gt;View中是通用的View，比如全项目通用的定制&lt;code&gt;AlertView&lt;/code&gt;，一模一样的Login界面。&lt;/p&gt;
&lt;p&gt;Category放通用的拓展类，比如说&lt;code&gt;NSCalendar&lt;/code&gt;在iOS8.0之后新增了很多日期计算和比较的Api，但是基于目前的项目大多数都需要最低支持iOS7.0，因此可以为&lt;code&gt;NSCalaner&lt;/code&gt;或者&lt;code&gt;NSDate&lt;/code&gt;写一些拓展方法，可以作为不同项目公用的工具。&lt;/p&gt;
&lt;p&gt;其他例如UserInfo还有Validation则是项目业务需求抽取，在此就不赘述了。&lt;/p&gt;
&lt;h3&gt;实战&lt;/h3&gt;&lt;p&gt;做好以上准备后，就可以进行业务开发了。多Target项目的开发和普通项目的开发并没有什么不同，只是在新建文件时，注意选择Target即可。&lt;br/&gt;&lt;img alt=&quot;选择Target&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;https://coding.net/u/Shengpan/p/Ghost-On-Coding-Paas/git/raw/master/images/%E5%A4%9ATarget%E5%BA%94%E7%94%A8%E6%9E%84%E6%9E%B6%E5%B0%8F%E7%BB%93/choose.png&quot;/&gt;&lt;/p&gt;
&lt;p&gt;另外，如果想调整文件的Target归属，只需要选择文件，在右边的工具窗口里的File Inspector选项下面，就可以找到与之前新建文件夹时相同的勾选项。勾选你想要的Target吧！&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;勾选Target&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;https://coding.net/u/Shengpan/p/Ghost-On-Coding-Paas/git/raw/master/images/%E5%A4%9ATarget%E5%BA%94%E7%94%A8%E6%9E%84%E6%9E%B6%E5%B0%8F%E7%BB%93/File_inspector.png&quot;/&gt; &lt;/p&gt;
&lt;p&gt;最后，在Debug和打包的时候，注意选择Target即可。&lt;/p&gt;
&lt;p&gt;&lt;img alt=&quot;选择target&quot; decoding=&quot;async&quot; loading=&quot;lazy&quot; src=&quot;https://coding.net/u/Shengpan/p/Ghost-On-Coding-Paas/git/raw/master/images/%E5%A4%9ATarget%E5%BA%94%E7%94%A8%E6%9E%84%E6%9E%B6%E5%B0%8F%E7%BB%93/change.png&quot;/&gt; &lt;/p&gt;
&lt;h3&gt;一些应该避免的坑&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;除了公用的模块，其他各自不同的类都加上前缀&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;由于OC并没有像Java命名空间一样的东西，因此在引入头文件时，如果文件名相同，编译器有时候会错误地引入头文件，这一就会导致找不到对应的方法，进而导致编译不通过。解决这个问题最直接了当的方法就是在新建每一个类的时候加上前缀。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;统一单独的常量或者宏定义文件&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;.h文件没有Target选项。因此，如果你有Define或者Constant一类的.h文件，要么为各自target用加前缀的方法创建不同的.h文件，要么将.h文件统一在Common中。不然会触发上面那个坑。&lt;/p&gt;</content:encoded></item></channel></rss>