iOS持续集成：命令行创建工程

在开发iOS应用的时候，大部分都是直接采用Xcode进行开发，但有时候需要用命令行来创建工程，比如最近在做ci的持续集成，就只能通过命令行的方式，这时候就需要了解一下工程文件的构成。我们知道工程文件的相关信息保存在project.pbxproj，因此可以通过脚本创建出pbxproj文件，完成基础工程的创建。

pbxproj

下面介绍一下pbxproj文件，可以拖动.xcodeproj文件到文本编辑器，如sublime，查看pbxproj文件的组成方式，主要包括：

• PBXBuildFile PBXFileReference
  这两个section保存中工程文件相关的信息:包含文件的类型，路径，名称等

/* Begin PBXBuildFile section */
    F60CC2A114D4EA0500A005E4 /* SocketOperation.m in Sources */ = {isa = PBXBuildFile; fileRef = F60CC2A014D4EA0500A005E4 /* SocketOperation.m */; };
/* End PBXBuildFile section */

/* Begin PBXFileReference section *
    F60CC2A014D4EA0500A005E4 /* SocketOperation.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SocketOperation.m; sourceTree = "<group>"; };
/* End PBXFileReference section */

• PBXGroup
  这个section保存着工程文件的分组信息：分组的名称，以及该组内含有的文件，比如下面的例子，一个TestChat分组里面还有一个Supporting Files子分组，同时该组包含AppDelegate的.h和.m两个文件，该分组对应的路径为TestChat：

* Begin PBXGroup section */
        F62417EA14D52F3C003CE997 /* TestChat */ = {
            isa = PBXGroup;
            children = (
                F62417EB14D52F3C003CE997 /* Supporting Files */,
                F62417F314D52F3C003CE997 /* AppDelegate.h */,
                F62417F414D52F3C003CE997 /* AppDelegate.m */,
            );
            path = TestChat;
            sourceTree = "<group>";
        };
/* End PBXGroup section */

• PBXNativeTarget
  该section保存工程创建的target信息：包含target的对应的配置信息、创建规则、依赖、名称和类型等信息

/* Begin PBXNativeTarget section */
CAC8612E08B161103B6C9DC7 /* UIModuleExample */ = {
            isa = PBXNativeTarget;
            buildConfigurationList = 56006E5E8040DE2B3965BE91 /* Build configuration list for PBXNativeTarget "UIModuleExample" */;
            buildPhases = (
                58D3152C3900AA8B62A79D47 /* Sources */,
                A5BF724742232AA0E86F3339 /* Frameworks */,
            );
            buildRules = (
            );
            dependencies = (
            );
            name = UIModuleExample;
            productName = UIModuleExample;
            productReference = 377070E96E22438316AB8879 /* UIModuleExample.app */;
            productType = "com.apple.product-type.application";
        };
/* End PBXNativeTarget section */

• XCBuildConfiguration XCConfigurationList
  这两个section保存着工程相关的配置信息：下面对应的是debug模式下的配置信息，可以看到里面包含CODE_SIGN_IDENTITY，sdk，framework的搜索路径等信息。

/* Begin XCBuildConfiguration section */
        F62417FD14D52F3C003CE997 /* Debug */ = {
            isa = XCBuildConfiguration;
            buildSettings = {
                "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
                FRAMEWORK_SEARCH_PATHS = (
                    "$(inherited)",
                    "\"$(DEVELOPER_FRAMEWORKS_DIR)\"",
                );
                GCC_PRECOMPILE_PREFIX_HEADER = YES;
                GCC_PREFIX_HEADER = "TestChat/TestChat-Prefix.pch";
                INFOPLIST_FILE = "TestChat/TestChat-Info.plist";
                IPHONEOS_DEPLOYMENT_TARGET = 5.0;
                OTHER_LDFLAGS = "-ObjC";
                PRODUCT_NAME = "$(TARGET_NAME)";
                TARGETED_DEVICE_FAMILY = "1,2";
                WRAPPER_EXTENSION = app;
            };
            name = Debug;
        };
/* End XCBuildConfiguration section */

通过上面分析一个pbxproj文件的过程可以看出，要创建一个工程，首先需要添加相关的文件，然后设置需要生成的target以及对应的配置信息就行了。

命令行生成pbxproj

上面大概了解了一个pbxproj文件的整体构造，要想生成一个这样的文件，可以自己按照对应的格式书写，或者借助一些脚本工具，这里推荐cocoapods的Xcodeproj，项目的地址：Xcodeproj ，该工具是用ruby语言实现的，可以用它来修改和创建pbxproj文件，下面是自己用ruby生成project文件的一部分示例代码：

  ＃创建 Example.xcodeproj工程文件，并保存
  Xcodeproj::Project.new("./Example.xcodeproj").save

  ＃打开创建的Example.xcodeproj文件
  proj=Xcodeproj::Project.open("./Example.xcodeproj")

  ＃创建一个分组，名称为Example，对应的路径为./Example
  exampleGroup=proj.main_group.new_group("Example","./Example")

  #给Example分组添加文件引用
  exampleGroup.new_reference("AppDelegate.h")
  ref1=exampleGroup.new_reference("AppDelegate.m")
  ref2=exampleGroup.new_reference("Images.xcassets")
  exampleGroup.new_reference("Base.lproj/LaunchScreen.xib")

 ＃在Example分组下创建一个名字为Supporting Files的子分组，并给该子分组添加main和info.plist文件引用
  supportingGroup=exampleGroup.new_group("Supporting Files")
  ref3=supportingGroup.new_reference("main.m")
  supportingGroup.new_reference("Info.plist")

 ＃创建target，主要的参数 type: application :dynamic_library framework :static_library 意思大家都懂的
 ＃name：target名称
 ＃platform：平台 :ios或者:osx
  target = proj.new_target(:application,"Example",:ios)

 #添加target配置信息
  target.build_configuration_list.set_setting('INFOPLIST_FILE', "$(SRCROOT)/Example/Info.plist")

  ＃target添加相关的文件引用，这样编译的时候才能引用到
  target.add_file_references([ref1,ref2,ref3])

  testGroup=proj.main_group.new_group("ExampleTests","./ExampleTests")
  ref4=testGroup.new_reference("ExampleTests.m")
  supportingGroup=testGroup.new_group("Supporting Files")
  supportingGroup.new_reference("Info.plist")

  ＃创建test target
  testTarget = proj.new_target(:unit_test_bundle,"ExampleTests",:ios,nil,proj.products_group)
  testRefrence = testTarget.product_reference
  testRefrence.set_explicit_file_type('wrapper.cfbundle')
  testRefrence.name = "ExampleTests.xctest"
  testTarget.add_file_references([ref4])
  
 ＃保存
  proj.save

通过上面的脚本生产的工程如下：

由于对ruby不太熟悉，因此有错误的地方欢迎提出！