環(huán)境:
Mac OS 10.13.3
Xcode 9.2
公司需要部門與部門之間的合作,需要部門提供一個SDK(.framework, .a都可以).
創(chuàng)建RX-iOS github
記得選擇 .gitignore 和 license
創(chuàng)建成功后:https://github.com/xzjxylophone/RX-iOS
在.gitignore 中添加
Podfile.lock
Pods
.DS_Store
Xcode framework創(chuàng)建
創(chuàng)建成功后顯示如下:
給這個SDK添加一個pod:
platform :ios, '8.0'
target 'RXSDK'
pod 'RXCategory'
inhibit_all_warnings!
現(xiàn)在要添加資源文件和相關(guān)的類
首先添加2個文件夾
在res添加bundle文件
添加完成后,顯示如下.
刪除RXSDK.bundle下所有的文件,并添加一個圖片文件
在src添加相關(guān)的類
其中比較重要的文件內(nèi)容:
讀取framework中bundle資源文件demo,具體是在UIImage+RXSDK.m 中:
+ (UIImage *)rxsdk_imageInBundle:(NSString *)imageName
{
NSString *name = [@"Frameworks/RXSDK.framework/RXSDK.bundle" stringByAppendingPathComponent:imageName];
UIImage *image = [UIImage imageNamed:name];
return image;
}
RXSDK.h文件和RXSDKHeader.h文件之間的關(guān)系
在RXSDK.h添加:
#import "RXSDKHeader.h"
在 RXSDKHeader.h中文件如下:
#import <UIKit/UIKit.h>
@interface RXSDK : NSObject
+ (UIView *)rxsdkView;
@end
注意上面的OC類名與文件名的關(guān)系.
這樣別人調(diào)用的時候就可以:
UIView *view = [RXSDK rxsdkView];
修改相關(guān)的配置項目
修改Mach-O Type
修改Build Phases中配置
把第二個紅色框中的RXSDKHeader.h拖動到第一個紅色框(也就是說你需要把所有需要開發(fā)中的.h文件拖到Public中去)
生成framework文件
選擇任意一個模擬器運行一次(command+B)(動作A)
選擇Generic iOS Device運行一次(command+B)(動作B)
在Products下的RXSDK.framework右擊后點擊Show in Finder后打開如下的文件夾:
選擇任意一個模擬器會生成-iphonesimulator下的sdk文件
選擇Generic iOS Device會生成-iphoneos下的sdk文件
此時顯示的都是Debug模式下的sdk文件.
實際上我們是需要release模式的,因此我們可以通過如下的方式來修改
選擇Edit Scheme(點擊選取Device旁邊的那個會彈出一個下拉框后選擇Edit Scheme)
把紅色框中的Debug改成Release后,點擊 Close
重新執(zhí)行動作A和動作B
這個時候再Show in Finder得到的文件如下:
以Release開頭的文件夾下的2個內(nèi)容就是我們所需要的
生成framework
需要合并這兩個文件,合并的命令和方式網(wǎng)上也有,此篇文章是使用腳本的方式完成合并.
插入一個知識點介紹:
需要合并的是第二個紅色框中的文件.把兩個目錄下的RXSDK文件合并成一個后,替換掉其中任何一個后,就是我們最終需要的framework
首先我們在
新建一個文件夾 BuildScript
在BuildScript添加一個sdkAggregate.sh文件
文件內(nèi)容如下:
#!/bin/bash
# = 前后不能有空格要不然會出錯
echo "run sdkAggregate script begin"
script_dir=${SRCROOT%/*}
target_name=${TARGET_NAME}
# framework的名稱
target_name=RXSDK
# framework的擴展名
framework_ext=.framework
framework_file_name=$target_name$framework_ext
# 編譯的目錄
# /Users/rush.d.xzj/Library/Developer/Xcode/DerivedData/HDRSDK-dhijegzprahyjqhahvwrkuecodnn/Build/Products/Release-iphoneos
# 去掉最后一個反斜杠后面的內(nèi)容
build_dir=${CONFIGURATION_BUILD_DIR%/*}
# 編譯的模式Debug Release
build_mode=${CONFIGURATION}
build_framework_path_iphoneos_for_framework=$build_dir/$build_mode-iphoneos/$framework_file_name
build_framework_merge_path_iphoneos=$build_framework_path_iphoneos_for_framework/$target_name
build_framework_merge_path_iphonesimulator=$build_dir/$build_mode-iphonesimulator/$framework_file_name/$target_name
echo $build_dir
echo $build_mode
echo $build_framework_merge_path_iphoneos
echo $build_framework_merge_path_iphonesimulator
sdk_home_dir=${SRCROOT%/*}
sdk_mid_build_framework_merge_path_tmp_dir=$sdk_home_dir/tmp
echo "中間臨時產(chǎn)生的目錄:$sdk_mid_build_framework_merge_path_tmp_dir"
# 判斷文件夾是否存在:
if [ ! -d "$sdk_mid_build_framework_merge_path_tmp_dir" ]; then
echo "dir not found need to mkdir"
mkdir $sdk_mid_build_framework_merge_path_tmp_dir
fi
sdk_mid_build_framework_merge_path_dir=$sdk_mid_build_framework_merge_path_tmp_dir/sdk_mid_build
echo "中間臨時產(chǎn)生的目錄:$sdk_mid_build_framework_merge_path_dir"
# 判斷文件夾是否存在:
if [ ! -d "$sdk_mid_build_framework_merge_path_dir" ]; then
echo "dir not found need to mkdir"
mkdir $sdk_mid_build_framework_merge_path_dir
fi
sdk_mid_build_framework_merge_path=$sdk_mid_build_framework_merge_path_dir/$target_name
# 先刪除文件
rm -rf $sdk_mid_build_framework_merge_path
echo "os需要合并的文件:$build_framework_merge_path_iphoneos"
echo "simulator需要合并的文件:$build_framework_merge_path_iphonesimulator"
echo "合并后的文件:$sdk_mid_build_framework_merge_path"
# 把os的和simulator的合并成一個
lipo -create "$build_framework_merge_path_iphoneos" "$build_framework_merge_path_iphonesimulator" -output "$sdk_mid_build_framework_merge_path"
sdk_release_output_framework_path_dir=$sdk_mid_build_framework_merge_path_tmp_dir/sdk_release_output
echo "中間臨時產(chǎn)生的目錄:$sdk_release_output_framework_path_dir"
# 判斷文件夾是否存在:
if [ ! -d "$sdk_release_output_framework_path_dir" ]; then
echo "dir not found need to mkdir"
mkdir $sdk_release_output_framework_path_dir
fi
sdk_release_output_framework_path=$sdk_release_output_framework_path_dir/$framework_file_name
echo "framework的生成后的路徑:$sdk_release_output_framework_path"
# 先刪除這個framework
rm -rf $sdk_release_output_framework_path
# 復(fù)制os中的framework到剛剛的framework路徑下
cp -a $build_framework_path_iphoneos_for_framework $sdk_release_output_framework_path
sdk_release_output_framework_path_file=$sdk_release_output_framework_path/$target_name
echo "需要被替換的文件路徑:$sdk_release_output_framework_path_file"
# 先刪除此文件
rm -rf $sdk_release_output_framework_path_file
# 再復(fù)制
cp -a $sdk_mid_build_framework_merge_path $sdk_release_output_framework_path_file
# TODD: 還需要copy相關(guān)文件到相關(guān)目錄下:
echo "run sdkAggregate script end"
給RXSDK工程添加一個Aggregate的Target
File->New Target->Cross-platform->Other下面的Aggregate
命名為:RXSDKBuild
點擊第三個紅色框中的加號
添加一個 New Run Script Phase
紅色框中輸入:
echo "run xcode script begin"
script_file_name=sdkAggregate.sh
script_dir=${SRCROOT%/*}/BuildScript # 坑爹啊 */
script_path=$script_dir/$script_file_name
# 獲取目錄的相關(guān)權(quán)限
chmod +x $script_dir
# 獲取文件的相關(guān)權(quán)限
chmod 764 $script_path
# 調(diào)用sh腳本文件
source $script_path
echo "run xcode script end"
修改RXSDKBuild的Scheme
把Debug修改成Release
這樣每次編譯的時候(動作C),會自動合并/生成/copy相關(guān)的文件到(注意查看相關(guān)的腳本文件):
修改.sh腳本運行的相關(guān)結(jié)果可以通過如下的方式查看:
創(chuàng)建framework的github的repository
生成framework的作用就是不想讓別人看到我們的代碼,因此我們還需要一個git地址,專門放framework文件.
在git上創(chuàng)建一個repository
git clone 到跟RX-iOS同一個目錄下:
繼續(xù)完善.sh腳本在上面的TODD下添加如下的腳本代碼
# 需要copy相關(guān)文件到相關(guān)目錄下, 放到framework的git文件下:
sdk_parent_path_dir=${script_dir%/*}
echo "sdk parent path:$sdk_parent_path_dir"
sdk_path_dir=${sdk_parent_path_dir}/RXSDK-iOS/RXSDK
echo "sdk path:$sdk_path_dir"
sdk_framework_file=$sdk_path_dir/$framework_file_name
echo "sdk framework file:$sdk_framework_file"
# 先刪除此文件
rm -rf $sdk_framework_file
# 復(fù)制framework文件夾
cp -a $sdk_release_output_framework_path $sdk_framework_file
# 最后刪除tmp文件夾
rm -rf $sdk_mid_build_framework_merge_path_tmp_dir
執(zhí)行動作C后,就會得到這樣的:
創(chuàng)建私有倉庫
具體可以參考:
http://m.itdecent.cn/p/ddc2490bff9f
前半部分.
此篇文章建立的私有倉庫地址是:
https://github.com/xzjxylophone/RXSpecs
上傳RXSDK到私有倉庫中
對于此篇文章示例工程的RXTmpSDK.podspecs文件如下:
Pod::Spec.new do |s|
s.name = "RXTmpSDK"
s.version = "0.2"
s.license = "MIT"
s.summary = "RXSDK is a framework"
s.homepage = "https://github.com/xzjxylophone/RXSDK-iOS"
s.author = { 'Rush.D.Xzj' => 'xzjxylophone@gmail.com' }
s.social_media_url = "http://weibo.com/xzjxylophone"
s.source = { :git => 'https://github.com/xzjxylophone/RXSDK-iOS.git', :tag => "v#{s.version}" }
s.description = %{
RXSDK is a framework.
}
s.vendored_frameworks = 'RXSDK/RXSDK.framework'
s.resource_bundle = {
'Paramount' => ['RXSDK/RXSDK.framework/RXSDK.bundle/*.*']
}
s.source_files = 'RXSDK/RXSDK.framework/Headers/*.h'
#s.frameworks = 'SystemConfiguration', 'Security', 'CoreGraphics', 'CoreTelephony'
s.requires_arc = true
#s.libraries = 'z', 'sqlite3', 'stdc++', 'iconv'
s.platform = :ios, '8.0'
end
保存后,cd到RXSDK-iOS 目錄下后依次運行---動作D
這里有一個問題,具體的解決方案看如下的連接中的問題2:
http://m.itdecent.cn/p/3d4d7dc5c6e1
git add --a
git commit -m "add"
git push origin master
git tag 'v0.2'
git push --tags
git push origin master
上面為什么是v0.2,因為我在嘗試v0.1的時候有其他地方出錯了,所以改成v0.2,記得也需要在.podspecs文件中修改為0.2
為什么是RXTmpSDK了? 因為在官網(wǎng)上已經(jīng)有一個RXSDK了~~~~~~~
添加到自定義的repository中去:
執(zhí)行命令:
pod repo push RXSpecs RXTmpSDK.podspec --verbose --allow-warnings
在寫代碼的過程中難免會有warning，記得最后一定要加上：
--allow-warnings
這樣就添加成功了!!!!
驗證我們的pod
新建一個工程,添加Podfile:
Podfile為什么會有:
pod 'RXCategory'
因為在我們的RXSDK中需要用到這個.
pod install一下(動作E)
在ViewController中添加如下代碼:
總結(jié)
至此我們整個流程就全部搞定了.
以后需要更新framework的話可以按照如下步驟
1.修改framework中的相關(guān)代碼
2.動作A
3.動作B
4.動作C
5.動作D (記得更新相關(guān)的tag)
6.動作E
步驟2至6也許可以做成一個 jenkins任務(wù)~~~~
這個是以后如果有需要的話,再去研究一下
歡迎留言與各種討論.
