iOS使用Workspace来管理多项目

参考:iOS使用Workspace来管理多项目,个人觉得这篇文章讲解的不错。

前言

Workspace,工作空间,可以用来管理多个Xcode Project,像Cocoapods一样,它的常见用法是编译静态库,然后给主工程使用,但跟普通的制作.a.framework不同的是,它不需要先打开静态库工程编译,然后将生成的.a.framework拷贝到主工程,最后再编译主工程,这样会造成很强的割裂感。Workspace只需要编译主工程,即可将依赖的工程一同编译,体验会更好一些。

制作Workspace

1.新建一个Workspace项目

菜单File -> New -> Workspace,新建一个Workspace项目,如下图所示,之后会生成一个.xcworkspace文件,双击打开该文件,会发现什么都没有,其实Workspace就类似一个文件夹,将不同的Project放在一起编译。

新建Workspace项目
2.向Workspace添加Project

本Demo包含2个Project,一个静态库项目BookObtain,另一个是主工程BookManager,如图,BookObtain用来模拟从网络下载书籍信息,BookManager用来展示下载的书籍信息。

Demo工程目录

BookObtain核心代码如下:


// BookObtain.h
#import <Foundation/Foundation.h>
#import "Book.h"

@interface BookObtain : NSObject

+ (Book *)obtainBookWithURL:(NSString *)urlString;

@end

// BookObtain.m
@implementation BookObtain

+ (Book *)obtainBookWithURL:(NSString *)urlString {
    NSDictionary *info = @{
        @"name": @"算法导论",
        @"price": @(125.0),
        @"content": @"内容太长,xxx意思一下..."
    };
    Book *book = [Book bookWithInfo:info];
    return book;
}

@end
// Book.h
#import <UIKit/UIKit.h>

NS_ASSUME_NONNULL_BEGIN

@interface Book : NSObject

@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) CGFloat price;
@property (nonatomic, copy) NSString *content;

+ (instancetype)bookWithInfo:(NSDictionary *)info;

@end

NS_ASSUME_NONNULL_END

// Book.m
#import "Book.h"

@implementation Book

- (instancetype)initWithInfo:(NSDictionary *)info {
    if (self = [super init]) {
        self.name = info[@"name"];
        self.price = [info[@"price"] floatValue];
        self.content = info[@"content"];
    }
    return self;
}

+ (instancetype)bookWithInfo:(NSDictionary *)info {
    return [[self alloc] initWithInfo:info];
}

@end

完成BookObtain代码编写,需要在主工程引用,这时候你会发现#import "BookObtain.h"报错,找不到头文件。这就是静态库引用需要做的第一件事:指定头文件路径

在主工程的 Build Settings -> Header Search Paths 添加一项 $(SRCROOT)/../BookObtain,并且设置为recursive。

指定静态库头文件

现在引入头文件不报错了,在主工程的ViewController.m中添加如下代码:

// 点击按钮回去书籍信息
- (IBAction)obtainBookInfo:(UIButton *)sender {
    Book *book = [BookObtain obtainBookWithURL:@"xxx"];
    self.bookLbl.text = [NSString stringWithFormat:@"name:%@\nprice:%.2lf\ncontent:%@", book.name, book.price, book.content];
}

编译,发现报错:

Undefined symbols for architecture arm64:

"_OBJC_CLASS_$_BookObtain", referenced from:

objc-class-ref in ViewController.o

这涉及到引用静态库的第二个问题:添加.a文件

在主工程的 Build Phases -> Link Binary With Libraries 添加 libBookObtain.a 文件,如下图:

添加静态库.a文件

至此,Workspace管理2个Project基本就完成了。

3.bundle携带资源文件

众所周知,.a文件是不能携带资源文件的,那如果静态库有资源文件怎么办呢?使用bundle。

BookObtain工程的TARGETS下添加一个新的target,类型是macOS下的Bundle,操作如下图:

添加bundle

注意:因为Bundle只在macOS下才有,所以创建完成之后,需要将该target的Base SDKmacOS改为iOS

然后将需要添加的资源文件拖到Bundle中即可。

添加资源文件到bundle

因为主工程需要使用该Bundle中的资源文件,所以需要保证该Bundle的target优先编译,修改主工程的Build选项,让该Bundle的target在主工程target之前进行编译。

bundle优先编译

最后,需要将该bundle编译的产物拷贝到主工程的main bundle下。

主工程的 Build Phases 左上角点击 + 号,添加一个New Run Script Phase,在里面添加拷贝bundle的脚本命令,如下:

#!/bin/sh
cp -R ${BUILT_PRODUCTS_DIR}/BookObtainBundle.bundle ${BUILT_PRODUCTS_DIR}/${TARGET_NAME}.app

然后就可以在主工程使用该bundle中的资源文件了。

NSString *bundlePath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"BookObtainBundle.bundle"];
NSBundle *bundle = [NSBundle bundleWithPath:bundlePath];
NSString *imgPath = [[bundle resourcePath] stringByAppendingPathComponent:@"1.jpeg"];
self.imgView.image = [UIImage imageWithContentsOfFile:imgPath];

总结

上面的Demo讲解了Workspace的用法,主要就是用来管理多个Project,这种方式可以消除普通静态库制作的割裂感,但是它也有弊端,就是代码是暴露出来的,比较适用于企业内部不同项目间共享代码。如果你不想让别人看到你的代码,那你只能用传统的制作静态库的方式了。

Demo地址

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容