iOS组件化 01 - 本地私有库的使用

使用 CocoaPods 创建模板库

1. 使用终端，创建模板（pod lib create 模板名）

pod lib create SLBaseKit

pod lib create SLBaseKit

2. 删除下图中红框的文件

remove files

3. 修改.gitignore文件，添加上面删除的文件

# .gitignore 

**/Pods/
**/*.xcworkspace

4. 提交本地仓库代码

git add .
git commit -m "create SLBaseKit project template & modify .gitignore"

5. 添加组件代码

(1) 拖入开发好的组件代码文件
(2) 删除 ReplaceMe.m 文件

SLBaseKit/SLBaseKit/Classes/

组件相关代码

//  SLSearchBar.h

#import 

NS_ASSUME_NONNULL_BEGIN

@interface SLSearchBar : UITextField

/**
 *  添加一个搜索框
 *
 *  @return 搜索框
 */
+ (instancetype)searchBar;

@end

NS_ASSUME_NONNULL_END

//  SLSearchBar.m

#import "SLSearchBar.h"

#define SLSearchBar_BundleName @"SLBaseKit"
@implementation SLSearchBar

+ (NSBundle *)currentBundle {
    static NSBundle *bundle;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        bundle = [NSBundle bundleWithPath:[[NSBundle bundleForClass:self]
                                           pathForResource:SLSearchBar_BundleName
                                           ofType:@".bundle"]];
        if (!bundle) bundle = [NSBundle mainBundle];
    });
    return bundle;
}

+ (instancetype)searchBar {
    SLSearchBar *searchBar = [[SLSearchBar alloc] init];
    searchBar.bounds = CGRectMake(0, 0, 300, 30);
    searchBar.font = [UIFont systemFontOfSize:13.0];
    searchBar.placeholder = @"请输入搜索内容条件";

    NSString *searchBarImagePath = [[self currendBundle] pathForResource:@"searchbar_textfield_background@2x" ofType:@"png"];
    UIImage *searchBarImage = [UIImage imageWithContentsOfFile:searchBarImagePath];
    
    CGFloat searchBarW = searchBarImage.size.width * 0.5;
    CGFloat searchBarH = searchBarImage.size.height * 0.5;
    
    // 设置背景图片为可拉伸模式的
    searchBar.background = [searchBarImage resizableImageWithCapInsets:UIEdgeInsetsMake(searchBarH, searchBarW, searchBarH, searchBarW) resizingMode:UIImageResizingModeStretch];
    
    UIImageView *searchIcon = [[UIImageView alloc] init];
    searchIcon.bounds = CGRectMake(0, 0, 30, 30);

    NSString *searchIconImagePath = [[self currentBundle] pathForResource:@"searchbar_textfield_search_icon@2x" ofType:@"png"];
    searchIcon.image = [UIImage imageWithContentsOfFile:searchIconImagePath];

    // 内容模式居中
    searchIcon.contentMode = UIViewContentModeCenter;
    
    // 左边的视图
    searchBar.leftView = searchIcon;
    // 显示模式
    searchBar.leftViewMode = UITextFieldViewModeAlways;
    
    return searchBar;
}

@end

（3）添加图片资源（如果你的组件没有依赖图片，可忽略此步骤）

add resource

（4） 打开SLBaseKit.podspec

open SLBaseKit.podspec

（5）修改SLBaseKit.podspec

#
# Be sure to run `pod lib lint SLBaseKit.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see https://guides.cocoapods.org/syntax/podspec.html
#

Pod::Spec.new do |s|
  s.name             = 'SLBaseKit' # 组件的名称
  s.version          = '0.1.0' # 版本
  s.summary          = 'SLBaseKit 是一个基础组件' # 摘要信息

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!
  
  # 描述信息
  s.description      = <<-DESC
  container
  1. SLSearchBar 继承了UITextField, 可以快速创建一个搜索框 
                       DESC

  s.homepage         = 'https://github.com/CoderSLZeng/SLBaseKit'  # 组件首页远程地址
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { '一夜知秋' => '[email protected]' }                                                # 作者联系方式
  s.source           = { :git => 'https://github.com/CoderSLZeng/SLBaseKit.git', :tag => s.version.to_s } # 源码远程地址
  # s.social_media_url = 'https://twitter.com/'

  s.ios.deployment_target = '8.0' # 最低部署版本

  s.source_files = 'SLBaseKit/Classes/**/*' # 源码所在路径
  
  # 如果你的组件没有使用到图片资源，可以注释掉下面3行
  s.resource_bundles = {
    'SLBaseKit' => ['SLBaseKit/Assets/*.png'] # 资源文件路径
  }

  # s.public_header_files = 'Pod/Classes/**/*.h' # 如果不开源，需要的接口头文件路径
  # s.frameworks = 'UIKit', 'MapKit' # 依赖的动态库
  # s.dependency 'AFNetworking', '~> 2.3' # 依赖的第三方框架
end

（6）回到刚才的终端，执行下面命令

# 根据自己的路径修改
cd SLBaseKit/SLBaseKit/Example
pod install

（7）打开SLBaseKit.xcworkspace，观察 Xcode 导航栏，可以看到组件代码和图片资源被添加到Development Pods 的相关文件夹中

Snip20191227_29.png

6. 测试组件

（1）在第1步创建组件模板的时候，已经默认创建好了一个Example for SLBaseKit 的测试工程，

Example for SLBaseKit

（2）同时观察Podfile文件，已经默认引用了SLBaseKit的本地库

Podfile

pod 'SLBaseKit', :path => '../' 默认是使用的本地库，后面还会讲解 远程库的使用
path => '../'表示到上一层目录的路径

目录层级

后期可根据的宿主工程所在路径自定义修改，例如：

组件化目录

# 编辑Podfile修改下面代码
 pod 'SLBaseKit', :path => '../../本地库/基础组件/基础/SLBaseKit/'

（2）修改 SLViewController.m

SLViewController.m

（2）编译测试工程，运行显示 UI 效果

SLViewController UI