上架

在过去七年时间里，我们的团队创建了无数iOS应用。在这个过程中我们不断改善我们的开发流程。把最佳实践应用到我们发布的新应用中。

我们已经准备好了两张核对清单。一个是关于如何开始一个iOS项目，一个是关于如何将应用提交到AppStore。

这些清单的流程使我们团队更高效，构建更好的解决方案，减少开发时间和提交到AppStore的风险。

我希望这些清单对你们同样有用。

####开始一个iOS项目

• Repo/Github

  1 在Github上创建一个仓库，把 iOS gitignore 文件添加进去。

  2 严格按照git-flow workflow流程进行开发，master分支用于你的产品发布，dev分支用于保持最新的代码，feature分支用于当前工作进度。

• Xcode

  1 确保团队中的每个人使用同一个版本的Xcode。

  2 在Xcode target的”Build Settings”里打开”Analyze during build”和 “Treat Warnings as Errors”选项。

  3 关闭tabs并开启空格键: XCode > Preferences > Text Editing > Indentation > Prefer Indent using Spaces, Tab width 2, Indent width 2

• Jenkins/OSX Server/TestFlight

  设置 CI/CD(持续集成/持续部署) 确保每次推送到dev分支的所有测试用例都会执行一遍，同时会构建一个Ad Hoc版本并以邮件形式发送到团队的每个成员（邮件内容是commit的log信息）。如果构建或者测试失败，一封构建失败的邮件也会发给团队成员。在Originate，大部分iOS项目都使用OSX Server集成TestFlight功能。

• 编码风格/规范

  1 遵循苹果官方的建议 iOS coding style guide

  2 此外，遵循这里的建议：http://qualitycoding.org/preprocessor/

  3 保持你的.h文件简洁。只暴露必要的接口给外界，把其他属性、方法、声明等放到.m文件

  4 根据当前显示的页面给ViewController命名。（e.g. LoginViewController）

  5 使用分组（Group）组织你的项目。好的分组应该是这样的：DataModels，Views，Controllers，App Delegate，Supporting Files，Tools等，混乱的项目结构是不能容忍的。

  6 在提交pull request之前，首先过一遍effective code review。

• 框架

  1 MVC（Model View Controller）有时候在iOS开发中会被戏称为Massive View Controller。对于初学者而言，把所有事情都交给massive controllers是一个很常见的错误。根据需求，我们应该把tableview相关的delegates/data sources从view controller中抽离成独立的类。把view（尤其是需要复用的）也抽离成单独的类。把controller中用到的工具性方法放到单独的helper类中去。此外，viewController不应该直接进行网路请求的操作，而应该交给Model或者Manager类去处理。

  2 一些好的code/tutorials/patterns: Lighter View Controllers, Viper andBrowseOverflow (from the iOS TDD book).

• Views/Nibs/Storyboards

  1 确保在视图中使用constraints/autolayout来适配不同的屏幕。否则只能手动为每个view设置frame sizes/positions来确保不同屏幕都正常显示。PureLayout和FLKAutoLayout已经在我们的一些项目里使用了。

  2 考虑要不要使用Nib文件。Originatge建议不要使用，但决定权应该交给Tech Lead。不建议使用Storyboard是因为对于多人开发很不友好，使Xcode变得迟缓，给写代码增加了不必要的复杂度。

  3 如果需要的话，使用FrameAccessor来修改frame，这将很容易设置UIView的大小和起始坐标。

• 字体和颜色

  对整个app进行字体和颜色标准化，这样就很容易维护和修改它们，并且可以使代码看起来更整洁。

• 文字显示

  1 所有显示到界面的字符串都要放到一个本地化文件（localization file）中。

  2 避免使用包含文本的image assets，使用UILabel替换之。

• 分析

  http://replay.io/ 是我们在Originate使用的分析平台

• 崩溃报告

  尽管苹果官方的iTunes Connect已经提供了相关功能，但是最好还是使用第三方的工具比如Crashlytics。它们很高效并且有一个更友好的界面。

• 如果需要，增加 AOP的支持(e.g. for logging)。

• 第三方代码依赖

  Cocoapods是个不错的选择。

• 服务器通信

  1 在应用的设置中增加toggle between server environments (e.g. QA, dev, staging, etc.)

  2 如果需要，实现一个app更新通知系统，这样服务器可以通知app有一个新的可用版本，app可以给用户展示相关更新提醒。

  3 在向服务器请求数据的时候，确保使用一个等待提示控件。我们在开发的时候用到了MRProgress。

  4 在网络请求中应该使用AFNetworking或者RestKit(if Core Data is needed)。网络优化/配置请看这篇博客：AFNetworking cache

  5 调试工程中，确保所有服务器信息都打印到控制台

  注意：使用 DLog 来打印所有的请求和响应(in debug mode)

  #ifdef DEBUG
  #define DLog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
  #else
  #define DLog(...);
  #endif
  

• 完善细节

细节的调整对于app来说是至关重要的。比如增加一些用户特别期待的特性比如：下拉刷新，点击状态栏滑到开头，请求数据的时候显示等待提示框等使你的app更友好。你的设计团队和产品团队应该有一个很高的水准。iOS Human Interface Guidelines是一个不错的参考。

最后，在开始之前，确保创建必须的账号(e.g. iTunes Connect, Urban Airship, Analytics Accounts, etc.)

####提交app到AppStore

发布app到AppStore不容忽视。我们必须按照苹果官方的指南一步一步进行以确保你的app能够顺利发布到AppStore。我们需要花费4~8个小时来执行这些步骤。

当你的app已经准备好了，按照下面步骤：

• Apple Guidelines

  1 为了高标准，苹果官方在App Distribution Guide提出了与App testing, Ad Hoc distribution, and App Store release相关的方方面面的要求。我们应该仔细阅读。

  2 当然，更重要的是这些文档我们应该熟记于心App Store Review Guidelines Common App Rejections

注意：我们发现开发者们经常忘记添加content flaging到那些创建用户生成数据的app中。苹果会拒绝这样的app，直到你把content flaging添加进去。

• Core Data

如果你的app中使用了CoreData，当你提交一个更新版本时，你必须确保写了一个迁移脚本来完成你的数据库升级。如果没有这样做，你的app在升级之后很可能会崩溃，用户只能删掉之后重新安装。请参考Core Data Model Versioning and Data Migration

• App评论窗口

当你想让你的应用程序被用户评论，UAAppReviewManager可以确保使你的app在合适的时间被用户评论。

• 发布方案

在Xcode的”Edit Scheme”选项，“Archive”应该设置成“Release”。这样可以隐藏log输出并关掉所有在开发阶段的测试用例

注意：由于编译器的优化设置，发布构建有时候与调试构建会有所不同。所以最好在发布到AppStore前几天就开始测试发布构建来捕获一些潜在的问题。

• 服务器

请将你的发布版本构建在生产服务器上

• 发布候选配置 Ad Hoc builds / App Store build

确保使用正确的Bundle Identifier, Apple ID, certificates (e.g. Push Certificates)等作为发布的候选配置和AppStore构建。

• 检查Release版的候选配置

  1 确保你的app与正确的生产服务器进行通信。

  2 确保所有的测试窗口是隐藏的

  3 确保没有敏感数据打印到控制台

  4 确保第三方分析工具比如Analytics工作在正确的生产账号上。

  5 确保第三方服务比如Urban Airship工作在正确的生产账号上。

• 推送到主分支

  1 在app的plist文件更新你的bundle version number。这个数字可以跟你在appStore里设置的版本号不一致，但最好还是设成一样的。

  2 推送你的代码到主分支并打上tag。

• 在iTunes Connect上设置你的app

  1 在iTunes Connect创建一个新的app，如果是升级的话，选“Add Version”

  2 确保填满所有信息并上传所有必要的图片（或者视频）

注意：只有“Description” 和 “What’s New In This Version”可以修改一旦你的app审核通过。其他的选项比如图片是不能修改的。

• 提交

使用Xcode来构建你的最终版本就上传到iTunes Connect。