Giters

xxhp / BWiOSPackage

iOS Package

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

![head](README/head.png)

BWiOSPackage

iOS Continuous Integration

Github：https://github.com/bobwongs/BWiOSPackage

Contents

  • iOS Xcode Project
  • Xcode打包
  • 脚本打包
  • iOS ipa包
  • 持续集成
  • 自动化测试
  • Reference
  • 经验总结
  • Follow Me

iOS Xcode Project

  • Workspace

    简单来说，Workspace就是一个容器，在该容器中可以存放多个你创建的Xcode Project， 以及其他的项目中需要使用到的文件。使用Workspace的好处有，1),扩展项目的可视域，即可以在多个项目之间跳转，重构，一个项目可以使用另一个项目的输出。Workspace会负责各个Project之间提供各种相互依赖的关系;2),多个项目之间共享Build目录。

  • Project

    指一个项目，该项目会负责管理生成一个或者多个软件产品的全部文件和配置，一个Project可以包含多个Target。

  • Target

    一个Target是指在一个Project中构建的一个产品，它包含了构建该产品的所有文件，以及如何构建该产品的配置。

  • Scheme

    一个定义好构建过程的Target成为一个Scheme。可在Scheme中定义的Target的构建过程有：Build/Run/Test/Profile/Analyze/Archive

  • Build Setting

    配置产品的Build设置，比方说，使用哪个Architectures？使用哪个版本的SDK？。在Xcode Project中，有Project级别的Build Setting，也有Target级别的Build Setting。Build一个产品时一定是针对某个Target的，因此，XCode中总是优先选择Target的Build Setting，如果Target没有配置，则会使用Project的Build Setting。

  • Build Phases

    • Target Dependencies
    • Compile Sources（编译资源，可设置Compiler Flags）
    • Link Binary With Libraries
    • Copy Bundle Resources（直接拷贝到包里面的资源）
    • Run Script（运行脚本，运行脚本不用拷贝到Bundle

Xcode打包

  • 打包机制

    • 流程
      xcodebuild -> Package；

  • xcodebuild

    • 流程细节
      Check dependencies（检查项目配置，如Code Sign） -> Preprocessor -> Compile -> Link -> Copy Resource、Compile Xib、CompileStoryboard、CompileAssetCatalog -> Generate DSYM File -> ProcessProductPackaging -> Code Signing（需要访问钥匙串信息） -> Validate -> Result；
    • Result
      .app和.DSYM；
    • Code Signing
      • Code Signing Identity
      • Provisioning Profile
    • Reference：Terminal执行命令，查看输出信息

  • Package

    • 把.app文件放入命名为“Payload”的新建文件夹中，对“Payload”文件夹进行压缩，对压缩生成的文件修改后缀名为.ipa，这样，就能生成有效的ipa包了；

  • Xcode可视化打包

    Select Generic iOS Device -> Xcode Menu Bar - Product -> Archive -> Select Package Type -> Select Provisoning Profile -> Export ipa or Upload to App Store

脚本打包

  • 脚本打包思路设计

    • 配置参数设计
    • 脚本修改项目配置和项目代码
    • xcodebuild clean和remove上次打包生成的文件
    • xcodebuild
    • Package, Denominate ipa file, Move files
    • Back up DSYM

  • 配置参数设计

    • 后台环境
    • 后台环境在App内的显示标识
    • 包类型
      • App Store
      • InHouse
      • Adhoc
    • App版本号
    • Build号
    • Bundle ID
    • Configuration-Release or Debug（一般不用设置）

  • Package, Denominate ipa file, Move files

    • Denominate ipa file
      • 格式：AppName Date Time Environment PackageType Version(BuildCode)
      • 示例：AppName 20161130 144130 生产环境 企业分发 版本号(Build号)

  • 命令

    • xcodebuild命令

      • 可构建的对象
        • workspace：必须和“-scheme”一起使用，构建该workspace下的一个scheme。
        • project：当根目录下有多个Project的时候，必须使用“-project”指定project，然后会运行
        • target：构建某个Target
        • scheme：和“-workspace”一起使用，指定构建的scheme。
      • 构建行为
        • clean:清除build目录下的文件，build目录和其子目录没有被移除
        • build: 构建
        • test: 测试某个scheme，必须和"-scheme"一起使用
        • archive:打包，必须和“-scheme”一起使用

    • 获取参数

      • $1、$2。。。、$n,n代表参数编号，$0为第一个参数，在此为脚本的路径，$#获取参数个数

        param1=$1
param2=$2

    • 文件操作

      • 查找文件

        • 命令：find

      • 修改文件

        • 修改文件名

          命令：mv（move files）

          mv file.txt new_file.txt  # 带上文件格式
mv directory new_directory  # 修改目录名

        • 查找和修改文件内容

          命令：sed（stream editor）

          替换指定文本
  sed -i ".tmp" "/words_to_find_which_line/s/replaced_word/new_word/" file_path
  参数说明
    -i：备份原文件，修改文件的操作不可逆，如果需要查看原来的内容，则可以在备份文件中进行查看，此脚本执行之后会生成一个.tmp文件，谨慎进行移除
    .tmp：备份的原文件名称
    words_to_find_which_line：通过文本找到需要修改的目标文本属于哪一行
    s：替换操作
    replaced_word：被替换的文本
    new_word：新文本
替换目标位置文本
  sed -i ".tmp" "/words_to_find_which_line/s/regular_expression/new_word/" file_path
  示例
    sed -i ".tmp" "/kEnvironment/s/=.*;/= new_tag;/" file_path  # 更换kEnvironment的值，不修改其余部分，如后面对代码的注释
    说明
      .*：正则表达式规则，“.”表示任意字符，“*”表示任意长度

      • 移除文件

        命令：rm（remove）

        rm path/file.format  # 移除文件
rm -r path/directory  # 移除目录，-r命令可以删除非空目录

      • 移动文件：mv（move files）

        mv file_path/file.format new_file_path/new_file.format

  • 项目的脚本

    • 本项目Shell脚本放置在工程根目录下，脚本文件为package.sh；

  • Reference

    • 终端查看对应的Manuel手册

  • 待完善

    • 脚本读取和修改Xcode工程文件信息，如版本号、包类型、授权文件等；
    • 脚本中的参数编写需要设计得更加灵活；

  • 学习方向

    • 正则表达式
    • Shell Script
    • 操作文本能力的提高
    • Python脚本的学习

iOS ipa包

  • ipa包的解压

    修改后缀名，把后缀名修改为Mac OS可解压的，如：ipa -> zip；

  • .app包转换为有效的.ipa包

    方式一：把.app文件拖入iTunes“我的应用”，再从iTunes中拖出来，就是一个.ipa文件啦；

    方式二：把.app文件放入命名为“Payload”的新建文件夹中，对“Payload”文件夹进行压缩，对压缩生成的文件修改后缀名为.ipa；

  • 从优秀App的ipa包中提炼信息

    如微信等知名应用的ipa包；

持续集成

  • 持续集成

    • 编译，发布，自动化测试
    • 目的
      • 减少风险
      • 减少重复过程

  • 自动化构建

    • 自动化构建的的首要前提

      Anyone should be able to bring in a virgin machine, check the sources out of the repository, issue a single command, and have a running system on their machine.

      自动化构建的的首要前提是有一个支持自动化构建的命令行工具，可以让开发人员可以通过一个简单的命令运行当前项目。

    • 命令行工具

      自动化构建的命令行工具比持续集成的概念要诞生得早很多，几十年前，Unix世界就已经有了Make，而Java世界有Ant，Maven，以及当前最流行的Gradle，.Net世界则有Nant和MSBuild。作为以GUI和命令行操作结合的完美性著称的苹果公司来说，当然也不会忘记为自己的封闭的iOS系统提供开发环境下命令行编译工具：xcodebuild

  • 持续集成平台Jenkins

  • 待研究，下载不了Jenkins

自动化测试

  • 自动化测试

Reference

构建iOS持续集成平台（一）——自动化构建和依赖管理：http://www.infoq.com/cn/articles/build-ios-continuous-integration-platform-part1/

一步一步构建iOS持续集成:Jenkins+GitLab+蒲公英+FTP：http://www.jianshu.com/p/c69deb29720d

手把手教你利用Jenkins持续集成iOS项目：http://gold.xitu.io/post/57b01d50128fe10055bbc6d5

Jenkins：https://jenkins.io/index.html

Manual：xcodebuild

经验总结

  • Mac OS Terminal中的Shell脚本命令操作后不可以撤销
  • Xcode Command+B是按照当前设定的Scheme进行Build，而不是固定选择Release进行Build

Follow Me

Github:https://github.com/BobWongs

About

iOS Package

Languages

Language:Objective-C 68.8%Language:Shell 31.2%