Swift下的组件化(多工程联编)

前言

最近公司新开了个项目，需要从零开始搭建，之前做过一些组件化的工作，但是之前的开发语言是OC，新项目切换到了Swift，虽然差异不大，但是还是写了本文作为记录

tips: 这篇文章写得不错 iOS swift的xcworkspace多项目管理（架构思想）

正如文章中所说，多工程需要面临的几个问题

各个工程如何创建，如何维护第三方的依赖（这里使用Cocopods进行依赖管理）
主工程如何调用Library工程
Library之前的依赖和调用

跟着我走一遍流程，follow me， Let's start it!

正文

一、主工程创建

首先，我们创建一个普通工程

创建普通工程

然后集成 Cocopods

step1:  cd /Volumes/SubMadao/git4Madao/ularization/ (你的工程目录)
step2:  pod init

然后编辑 podfile

platform:ios,'8.0'
inhibit_all_warnings!
use_frameworks!

# workspace
def workspace_pods
end


target 'Modularization' do
  workspace_pods
  target 'ModularizationTests' do
    inherit! :search_paths
  end

  target 'ModularizationUITests' do
    inherit! :search_paths
  end
end

step3:  pod install

WorkSpace

那么，我们的工作空间（WorkSpace）也就创建好了，其实也就是Cocopods集成的基本流程

二、Library创建和关联

我们暂定各个模块如下（借鉴他人）：

主工程：承载主要的表层业务代码
Core：独立存在，应用加密，接口请求认证等敏感代码
Base：基类封装，拓展，基本的数据处理
Service：服务层，封装业务工具类，网络层服务，持久化层服务等
Pods: 三方依赖

依赖架构

创建各个Base ，Service ，Core等Library

new project 新建一个工程并选择 Cocoa Touch Framework类型

new project

加入正确的 Group和 WorkSpace

add to WorkSpace

然后需要将 Mach-O Type 修改为静态库 Static Library

Static Library

如此重复，创建 Base ，Service ，Core

项目总览

到这里，项目架构的基本雏形已经出来了，但是工程中各个Library之间并没有相互依赖的关系

三、主工程调用Library

设置依赖

Linked Frameworks Libraries 中添加即可，添加之后，只需要Build主工程，Library能够自动联编

创建文件

很自然地，我们需要在主工程中调用Library中的文件，那么我们在 MADCore 中添加一个文件

///  MADCoreSettings.swift
import UIKit
// 类需要声明为 Public
public class MADCoreSettings: NSObject {

    // 属性需要声明为 Public
    public static let SECRET_KEY = "SECRET_KEY"
}

还需要在 Building Phases 中的 Headers 中添加为 Public

Building Phases

import UIKit
import MADCore

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // 调用 MADCore库文件
        let key = MADCoreSettings.SECRET_KEY
    }
}

这样子，只需要 import MADCore 即可调用 MADCore 库中的文件了

四、子工程Library互相调用

也和主工程调用Library类似，对应添加依赖即可，暴露header即可

五、Cocopods 管理主工程和 Library的三方依赖

我们需要在 Service 中封装网络层的代码，那么我们需要用Cocopods为Library添加三方依赖

platform:ios,'8.0'
inhibit_all_warnings!
use_frameworks!

workspace 'Modularization.xcworkspace'

########################################  dependency

# workspace
def workspace_pods
    
    # react
    pod 'RxSwift'
    pod 'RxCocoa'
    
    # orm
    pod 'ObjectMapper', '~> 3.3.0'
    pod 'SwiftyJSON'
end

# main project dependency
def project_only_pods
    
    pod 'SnapKit', '~> 4.0.0'
    pod 'Kingfisher', '~> 4.0'
    pod 'MJRefresh'
    pod 'MJExtension'
    pod 'MD-UITableView+FDTemplateLayoutCell'
    pod 'SVProgressHUD', '2.0.4'
end

# network layer dependency
def network_layer_pods
    
    pod 'Moya/RxSwift', '~> 11.0'
    pod 'Moya', '~> 11.0.2'
    pod 'Alamofire', '~> 4.5'
end

######################################## main project

target 'Modularization' do

    workspace_pods
    project_only_pods
    network_layer_pods

    target 'ModularizationTests' do
        inherit! :search_paths
    end

    target 'ModularizationUITests' do
        inherit! :search_paths
    end
end

######################################## Library

# Service
target 'MADService' do
    project 'MADService/MADService.xcodeproj'
    
    #
    workspace_pods
    network_layer_pods
end

# Base
target 'MADBase' do
    project 'MADBase/MADBase.xcodeproj'
    
    #
    workspace_pods
end

# Core
target 'MADCore' do
    project 'MADCore/MADCore.xcodeproj'
    
    #
    workspace_pods
end

需要注意的两行是

workspace 'Modularization.xcworkspace'

project 'MADService/MADService.xcodeproj'
project 'MADBase/MADBase.xcodeproj'
project 'MADCore/MADCore.xcodeproj'

接下来只需要 pod install 即可完成我们的配置依赖

分别配置了 workspace 的文件路径，和子project的路径

以此为基础，使用 Moya + RxSwift 封装了网络层的请求代码，仅供参考

网络层封装

最后

到这里，我们已经完成了组件化的基本操作和配置，只要愉快地填充代码就可以啦，常规惯例Demo传送门：GITHUB