🌈Cocoapods私有库创建方法总结

🌈Cocoapods私有库创建方法总结 创建Cocoapods私有库有一个全局了解,主要步骤总结如下:

  1. 创建私有Spec仓库
  2. 创建源码库,并git clone到本地
  3. 创建Cocoapods私有库模板
  4. 编写Cocoapods私有库podspec文件
  5. 添加源码和资源文件到指定的文件夹中(每次更改都需要在Example文件夹中pod install一下)
  6. 验证podspec文件是否无误
  7. 移动Cocoapods私有库模板中的文件到源码库
  8. 提交源码到git仓库,并打tag
  9. 将 podspec 提交到spec仓库
  10. 在项目中使用私有库

1、创建私有Spec仓库

执行repo 命令添加私有库Repo 打开终端,在任意目录下执行下面的命令:

pod repo add MOJiBaseSpec http://192.168.1.3/moji-cocoapods/MOJiBaseSpec.git

解释:
pod repo add 【私有库名称】【1.1中创建的远程仓库的git地址】

如果需要更改,用以下命令删除并重复上一步

pod repo remove REPO_NAME

成功后,我们将在以下目录中看到我们所创建的私有库文件夹

~/.cocoapods/repos

2、创建源码库,并git clone到本地

3、创建Cocoapods私有库模板

cd到你要储存项目的文件夹,使用以下命令创建Cocoapods私有库模板

pod lib create MOJiBase

紧接着,会有一些参数需要配置:(语言根据实际情况选择,生成的结构都是一样的,只是生成的默认语言会不一样)

配置完成后,会自动打开创建的项目

4、将pod创建的项目文件copy到MOJiBase本地仓库里

最终如如下图所示:

5、配置podspec文件

打开 MOJiBase本地仓库中的 Example 中的工程

选择 MOJiBasepodspec 文件进行编辑:

相关字段可以查询官方文档【Podspec Syntax Reference】。

以下是MOJiBase.podspec文件示例,仅供参考。

#
# Be sure to run `pod lib lint MOJiBase.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           = 'MOJiBase'
 s.version        = '1.3.11'
 s.summary        = 'MOJi基础工具类库,其中包括一些UI功能,后期需要剥离'
 s.swift_version  = '5.0'

# 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
TODO: Add long description of the pod here.
            DESC

 s.homepage      = 'http://192.168.1.3/moji-cocoapods/mojibase.git'
 # s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
 s.license       = { :type => 'MIT', :file => 'LICENSE' }
 s.author        = { '赵汉军' => 'zhaohanjun@mail.shareintelli.com' }
 s.source        = { :git => 'http://192.168.1.3/moji-cocoapods/mojibase.git', :tag => s.version.to_s }
 # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

 s.ios.deployment_target = '11.0'

 s.source_files = 'MOJiBase/Classes/**/*'
  
 s.resource_bundles = {
  #'MOJiBase' => ['MOJiBase/Assets/*.png']
  #'MOJiBase' => ['MOJiBase/base-images/*.png']
  'MOJiBase'  => ['MOJiBase/**/*.{xib,bundle}']
#  'MOJiBase' => ['MOJiBase/Assets/base-images.bundle']
 }

 # s.public_header_files = 'Pod/Classes/**/*.h'
  s.frameworks = 'UIKit', 'Foundation'
  s.dependency 'SVProgressHUD'
  s.dependency 'SwiftyJSON'
  s.dependency 'SnapKit'
  
end

相关字段解释:

//私有库对应的版本号
s.version     = '1.3.11'
//私有库描述,最好写一下,不然最终验证的时候会报警告⚠️
s.summary     = 'MOJi基础工具类库,其中包括一些UI功能,后期需要剥离'
//如果使用的是swift,需要指定使用的版本,否则有可能编译不过,最终验证也会报警告
s.swift_version  = '5.0'
//仓库地址,必须得写,否则后面spec文件会上传不成功
s.source      = { :git => 'http://192.168.1.3/moji-cocoapods/mojibase.git', :tag => s.version.to_s }
//源码文件路径
s.source_files = 'MOJiBase/Classes/**/*'
//指定的资源文件读取路径,xib、png、bundle、Assets都需要指定
s.resource_bundles = {
 'MOJiBase' => ['MOJiBase/**/*.{xib,bundle}']
}
//依赖的系统库
s.frameworks = 'UIKit', 'Foundation'
//依赖的第三方库
s.dependency 'SnapKit'

提示:每次更改podspec文件都必须pod install才会生效

6、添加源码和资源文件:

如图所示:

Classes存放所有的代码文件Assets存放所有的资源文件

1、访问图片资源、bundle、xib等文件

1、因为pod会将我们的bundle、xib、png等资源文件打包进pod项目的mainBundle中的Base.framework中,所以不能用以前的方式直接读取图片,而且实用NSBundle.mainBundle也容易和主项目产生冲突。

OC版本:新建NSBundle+Extension分类

+ (NSBundle *)bundleWithBundleName:(NSString *)bundleName podName:(NSString *)podName {
  if (bundleName == nil && podName == nil) {
    @throw @"bundleName和podName不能同时为空";
  }else if (bundleName == nil ) {
    bundleName = podName;
  }else if (podName == nil) {
    podName = bundleName;
  }
   
   
  if ([bundleName containsString:@".bundle"]) {
    bundleName = [bundleName componentsSeparatedByString:@".bundle"].firstObject;
  }
  //没使用framwork的情况下
  NSURL *associateBundleURL = [[NSBundle mainBundle] URLForResource:bundleName withExtension:@"bundle"];
  //使用framework形式
  if (!associateBundleURL) {
    associateBundleURL = [[NSBundle mainBundle] URLForResource:@"Frameworks" withExtension:nil];
    associateBundleURL = [associateBundleURL URLByAppendingPathComponent:podName];
    associateBundleURL = [associateBundleURL URLByAppendingPathExtension:@"framework"];
    NSBundle *associateBunle = [NSBundle bundleWithURL:associateBundleURL];
    associateBundleURL = [associateBunle URLForResource:bundleName withExtension:@"bundle"];
  }
   
  NSAssert(associateBundleURL, @"取不到关联bundle");
  //生产环境直接返回空
  return associateBundleURL?[NSBundle bundleWithURL:associateBundleURL]:nil;
}

Swift版本

extension Bundle {
   
  class func fetchBundle(bundleName: String?, podName: String?) -> Bundle? {
    var bundleName = bundleName
    var podName  = podName
    //判断参数
    if bundleName == nil && podName == nil {
      assert((bundleName != nil), "bundleNameh 和 podName不能同时为空")
    } else if (bundleName == nil) {
      bundleName = podName
    } else if (podName == nil) {
      podName = bundleName
    }
    //适配名称
    if ((bundleName?.contains(".bundle")) != nil) {
      bundleName = bundleName?.components(separatedBy: ".bundle").first
    }
    var associateBundleURL = Bundle.main.url(forResource: bundleName, withExtension: "bundle")
    //如果associateBundleURL为空,则走下面方法
    if associateBundleURL == nil {
      associateBundleURL = Bundle.main.url(forResource: "Frameworks", withExtension: nil)
      associateBundleURL = associateBundleURL?.appendingPathComponent(podName!)
      associateBundleURL = associateBundleURL!.appendingPathExtension("framework")
      let associateBunle = Bundle(url: associateBundleURL!)
      associateBundleURL = associateBunle?.url(forResource: bundleName, withExtension: "bundle")
    }
    assert((associateBundleURL != nil), "取不到关联bundle")

    return Bundle(url: associateBundleURL!) ?? nil
     
  }
}

7、验证podspec文件是否无误

1、主要使用命令

cd 到 MOJiBase项目文件夹下。其目录下有 MOJiBase.podspec 文件。

执行以下命令:

pod lib lint --allow-warnings
#严谨一点,可以不忽略警告⚠️,如下
pod lib lint

如果验证成功将会显示如下图:

如果报Error可以用如下命令查看详细错误信息:

pod lib lint --verbose 

2、常见的几个警告⚠️信息

1、summary: The summary is not meaningful.

解释:这是因为你没有修改 .podspec 文件中的 s.summary 字段。只需要修改 .podspec 文件即可,如下:

s.summary          = '这是一个测试组件库'

2、swift: The validator used Swift 3.2 by default because no Swift version was specified

解释:没有指定Swift版本,只需要在 .podspec 增加对swift版本指定即可,如下:

s.swift_version  = '5.0'

解决完上面两个WARN之后,再执行pod lib lint --allow-warnings 命令就会发现没有警告了。

后续欢迎补充更多“常见错误”以帮助开发小伙伴避坑!

8、提交MOJiBase到gitlab仓库

按照如下步骤进行git操作:

git add --all
git commit -a -m "第一次提交"
git push origin master
git tag 1.3.11
git push --tags

9、将podspec提交到gitlab

cd 到 MOJiBase项目文件夹下。其目录下有MOJiBase.podspec 文件。运行如下命令:

pod repo push BOTestSpec MOJiBase.podspec --allow-warnings
#命令解释
#pod repo push 【私有库名称】 【podspec文件名】 --allow-warnings

上传成功后将会显示如下信息:

显示如上信息后,你还可以查看 ~/.cocoapods/repos。在 MOJiBaseSpec 仓库下会多新增 MOJiBase 文件夹。如下所示:

至此,你的私有库已制作完成。你和你的小伙伴们可以在项目中使用它了。

10、在你的项目中使用你的私有库

1、创建MOJiBaseTest测试项目。

2、在项目目录下,执行命令:

pod init

3、编辑 podfile 文件:

platform :ios, '9.0' 
source 'http://192.168.1.3/moji-cocoapods/mojibase.git' # 官方库
source 'http://192.168.1.3/moji-cocoapods/MOJiBaseSpec.git'# 私有库Repo地址 
target 'BOSpecDemo' do # Comment the next line if you're not using Swift and don't want to use dynamic frameworks 
use_frameworks! 
# Pods for MOJiBaseTest 
pod 'MOJiBase' 
end

注意:私有仓库的地址一定是Spec Repo 的地址,不要错误的使用MOJiBase组件的git仓库。

然后执行 pod install,添加私有库到工程中。

关于散列表的研究以及NSDictionary底层探索

关于散列表的研究以及NSDictionary底层探索

有道笔记链接:https://note.youdao.com/s/FsSLFw9k

众所周知,在iOS开发当中便利一个数组,去不断匹配value是一种很低效的方式,但是如果直接通过NSarry的index(索引)去取值,则会快很多,但是字典是无序的,也就是没有一个对外暴露的索引,我们该如何通过字典的key去快速定位Value呢?

在了解这些之前,我们就必须要了解散列表,即哈希表(Hash table)。

散列表(Hash table,也叫哈希表),是根据键(Key)而直接访问在内存存储位置的数据结构。也就是说,它通过计算一个关于键值的函数,将所需查询的数据映射到表中一个位置来访问记录,这加快了查找速度。这个映射函数称做散列函数,存放记录的数组称做散列表。

所以我们知道哈希表底层其实是一个数组,那么只要我们通过一定的算法将key值转化为数组中index和value的对应关系就可以极大的提升字典差值的效率了。

话不多说,开搞!

已知Key对象的值为0b0000 0001(计算机储存的所有对象都为二进制数据),当我们设定这个key的时候,我们会通过一个hash函数去生成一个特定索引。这个函数可能是用“&”与运算符,也可能用“%”取余,不同平台的算法各不相同,但都是相通的。

比如我们定义一个mask,值为:0b0000 1111(取余即为15);我们用key1 & mask,如下:

//通过“&”运算符,我们得到一个明确的索引,即1。
  0b0000 0001
& 0b0000 1111
--------------
  0b0000 0001

哈希表对应分布如下:

索引value
0NULL
1buket(key1,value2)
2NULL
3NULL
4NULL
5NULL

如果我们继续往字典储存新值,如key2为:0b0000 0010

//通过“&”运算符,我们得到一个明确的索引,即2。
  0b0000 0010
& 0b0000 1111
--------------
  0b0000 0010

哈希表对应分布如下:

索引(地址)value
0NULL
1buket(key1,value2)
2buket(key2,value2)
3NULL
4NULL
5NULL

以此类推,我们将会得到一个Array,所以了解了这些后,我们很容易就明白,当我们传入一个key时,字典并不是通过key去循环便利去找出我们想要的value,而是通过一个函数去生成value的一个索引,从而更精准的定位我们想要的value,如传入:(0b0000 0001),我们就得到了索引为1,再通过索引1,直接拿到Value。

那么新问题产生了!

在上面我们定义了一个mask为0b0000 1111的值,根据“&”运算的逻辑,值都为1才为1,只要其中有一个为0,则为0。所以我们得到的索引最大值都不会超过mask,即15。即数组内储存的元素最多不能超过15条。

  1. 那么一旦超过呢?没错,字典底层为我们编写了“扩容”的操作。(源码如下)
  2. 如果生成的索引index已经被占用了呢?这时候iOS底层源码编写了向前/向后查找,直到查找到存在空位时,储存(但是实际开发中,冲突很麻烦,甚至会影响散列表的查找速度,所以应该采用最大限度减少冲突的散列函数)。

下面时iOS中字典扩容的源码,有兴趣的可以看一下。 iOS CFDictionary源码

//字典结构体
struct __CFDictionary {
    CFRuntimeBase _base;
    CFIndex _count;		/* number of values */
    CFIndex _capacity;		/* maximum number of values */
    CFIndex _bucketsNum;	/* number of slots */
    uintptr_t _marker;
    void *_context;		/* private */
    CFIndex _deletes;
    CFOptionFlags _xflags;      /* bits for GC */
    //保留的所有的key
    const void **_keys;		/* can be NULL if not allocated yet */
    //保存了所有value
    const void **_values;	/* can be NULL if not allocated yet */
};
static void __CFDictionaryGrow(CFMutableDictionaryRef dict, CFIndex numNewValues) {
    //获得原有的keys和values
    const void **oldkeys = dict->_keys;
    const void **oldvalues = dict->_values;
    //原来插槽数
    CFIndex idx, oldnbuckets = dict->_bucketsNum;
    //原来字典中的values
    CFIndex oldCount = dict->_count;
    CFAllocatorRef allocator = __CFGetAllocator(dict), keysAllocator, valuesAllocator;
    void *keysBase, *valuesBase;
    dict->_capacity = __CFDictionaryRoundUpCapacity(oldCount + numNewValues);
    dict->_bucketsNum = __CFDictionaryNumBucketsForCapacity(dict->_capacity);
    dict->_deletes = 0;
    if (_CFDictionaryIsSplit(dict)) {   // iff GC, use split memory sometimes unscanned memory
    unsigned weakOrStrong = (dict->_xflags & __kCFDictionaryWeakKeys) ? AUTO_MEMORY_UNSCANNED : AUTO_MEMORY_SCANNED;
    void *mem = _CFAllocatorAllocateGC(allocator, dict->_bucketsNum * sizeof(const void *), weakOrStrong);
        CF_WRITE_BARRIER_BASE_ASSIGN(allocator, dict, dict->_keys, mem);
        keysAllocator = (dict->_xflags & __kCFDictionaryWeakKeys) ? kCFAllocatorNull : allocator;  // GC: avoids write-barrier in weak case.
        keysBase = mem;
    
        weakOrStrong = (dict->_xflags & __kCFDictionaryWeakValues) ? AUTO_MEMORY_UNSCANNED : AUTO_MEMORY_SCANNED;
    mem = _CFAllocatorAllocateGC(allocator, dict->_bucketsNum * sizeof(const void *), weakOrStrong);
        CF_WRITE_BARRIER_BASE_ASSIGN(allocator, dict, dict->_values, mem);
        valuesAllocator = (dict->_xflags & __kCFDictionaryWeakValues) ? kCFAllocatorNull : allocator; // GC: avoids write-barrier in weak case.
        valuesBase = mem;
    } else {
        //扩容成原先大小的两倍
        CF_WRITE_BARRIER_BASE_ASSIGN(allocator, dict, dict->_keys, _CFAllocatorAllocateGC(allocator, 2 * dict->_bucketsNum * sizeof(const void *), AUTO_MEMORY_SCANNED));
        dict->_values = (const void **)(dict->_keys + dict->_bucketsNum);
        keysAllocator = valuesAllocator = allocator;
        keysBase = valuesBase = dict->_keys;
    }
    if (NULL == dict->_keys || NULL == dict->_values) HALT;
    if (__CFOASafe) __CFSetLastAllocationEventName(dict->_keys, "CFDictionary (store)");
    // 重新计算keys数据的hash值,存放到新的数组中
    for (idx = dict->_bucketsNum; idx--;) {
        dict->_keys[idx] = (const void *)dict->_marker;
        dict->_values[idx] = 0;
    }
    if (NULL == oldkeys) return;
    for (idx = 0; idx < oldnbuckets; idx++) {
        if (dict->_marker != (uintptr_t)oldkeys[idx] && ~dict->_marker != (uintptr_t)oldkeys[idx]) {
            CFIndex match, nomatch;
            __CFDictionaryFindBuckets2(dict, oldkeys[idx], &match, &nomatch);
            CFAssert3(kCFNotFound == match, __kCFLogAssertion, "%s(): two values (%p, %p) now hash to the same slot; mutable value changed while in table or hash value is not immutable", __PRETTY_FUNCTION__, oldkeys[idx], dict->_keys[match]);
            if (kCFNotFound != nomatch) {
                CF_WRITE_BARRIER_BASE_ASSIGN(keysAllocator, keysBase, dict->_keys[nomatch], oldkeys[idx]);
                CF_WRITE_BARRIER_BASE_ASSIGN(valuesAllocator, valuesBase, dict->_values[nomatch], oldvalues[idx]);
            }
        }
    }
    CFAssert1(dict->_count == oldCount, __kCFLogAssertion, "%s(): dict count differs after rehashing; error", __PRETTY_FUNCTION__);
    _CFAllocatorDeallocateGC(allocator, oldkeys);
    if (_CFDictionaryIsSplit(dict)) _CFAllocatorDeallocateGC(allocator, oldvalues);
}

但是扩容有一个很明显的缺点,就是会让字典的容量越来越大,甚至产生很多空间的浪费。所以哈希表是一种用空间换效率的技术。(会空闲一部分内存)

总结一下,所以散列表的核心是散列函数,大致可以用如下函数表示,不管是用“%”取余,还是用与运算符“&”,我们所定义的mask都决定了散列表的容量大小,所以应尽可能优化散列函数,避免mask的频繁变动和散列表数据的冲突,保证散列表查询的效率。以上就是我对于散列表的理解和研究,如果错漏,还请大家踊跃提出,共同交流。

f(key) == index

下面补充几个网上推荐的hash表函数:

相关参考文档补充 iOS字典底层原理:https://www.jianshu.com/p/0d7cd6341f65 iOS 用OC简单还原hash值生成

—–zhaohanjun