- 存放类的地方
- 存放图片资源的地方
- 打包生成的方式
第一步:创建一个新的"Cocoa Touch Static Library"工程
Static Library生成的是libSerenity.a的静态库文件.
而我们最终要生成的是Serenity.framework的方式.
创建:
第二步:创建主框架的头文件
如果你希望其他开发者以<Serenity/Serenity.h> 的方式来使用你自己的静态库.那么你需要确保你的项目中包含该头文件.例如:
#import <Foundation/Foundation.h>
#import <Serenity/Widget.h>
(ps : Widget.h 是你项目中的其他文件)
一旦你创建了framew得头文件,你需要将这些头文件列为"public"的状态.
第三步 : 更新Public类型头文件的地址
默认情况下,静态库项目将私人的和public头文件复制在同一文件夹路径下: /usr/local/include. 为了避免错误的将私人标题复制到我们的框架,我们想确保我们的public头文件复制到一个单独的目录中. 例如 :$(PROJECT_NAME)Headers. 要去修改这些设定.
编译后
修改后
$(PROJECT_NAME)Headers
再次编译
接下来考虑: 添加一些新的资源到Framework
不管你什么时候要添加一些新的类,你将要考虑是否将这些.h文件是否置为public的状态,因为默认是Project的状态,默认不会拷贝到你刚刚创建的自定义的头文件路径.
这里添加一个新的NewSource的类测试.
测试结果:
第四步 : Disable Code Stripping
We do not want to strip any code from the library; we leave this up to the application that is linking to the framework. To disable code stripping we must modify the following configuration settings:
"Dead Code Stripping" => No (for all settings)
"Strip Debug Symbols During Copy" => No (for all settings)
"Strip Style" => Non-Global Symbols (for all settings)
第五步 : 开启所有architecture支持
我们需要我们的framework可以用于所有的不同设备,所有不同的架构体系
"Build Active Architecture Only" => No (for all settings)
第六步: 生成架构(以framework的形式)
首先 : 创建文件目录布局
set -e
mkdir -p "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.framework/Versions/A/Headers"
# Link the "Current" version to "A"
/bin/ln -sfh A "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.framework/Versions/Current"
/bin/ln -sfh Versions/Current/Headers "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.framework/Headers"
/bin/ln -sfh "Versions/Current/${PRODUCT_NAME}" "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.framework/${PRODUCT_NAME}"
# The -a ensures that the headers maintain the source modification date so that we don't constantly
# cause propagating rebuilds of files that import these headers.
/bin/cp -a "${TARGET_BUILD_DIR}/${PUBLIC_HEADERS_FOLDER_PATH}/" "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.framework/Versions/A/Headers"
编译生成
生成的目录结构:
Serenity.framework/
Headers/ -> Versions/Current/Headers
Serenity -> Versions/Current/Serenity
Versions/
A/
Headers/
Serenity.h
Widget.h
Current -> A
接下来: 生成Framework的发布目标
-
创建一个新的Aggregate 目标
-
添加Static Library作为独立的目标
-
修改配置Architecture
-
构建其他平台
添加脚本
set -e
set +u
# Avoid recursively calling this script.
if [[ $SF_MASTER_SCRIPT_RUNNING ]]
then
exit 0
fi
set -u
export SF_MASTER_SCRIPT_RUNNING=1
SF_TARGET_NAME=${PROJECT_NAME}
SF_EXECUTABLE_PATH="lib${SF_TARGET_NAME}.a"
SF_WRAPPER_NAME="${SF_TARGET_NAME}.framework"
# The following conditionals come from
# https://github.com/kstenerud/iOS-Universal-Framework
if [[ "$SDK_NAME" =~ ([A-Za-z]+) ]]
then
SF_SDK_PLATFORM=${BASH_REMATCH[1]}
else
echo "Could not find platform name from SDK_NAME: $SDK_NAME"
exit 1
fi
if [[ "$SDK_NAME" =~ ([0-9]+.*$) ]]
then
SF_SDK_VERSION=${BASH_REMATCH[1]}
else
echo "Could not find sdk version from SDK_NAME: $SDK_NAME"
exit 1
fi
if [[ "$SF_SDK_PLATFORM" = "iphoneos" ]]
then
SF_OTHER_PLATFORM=iphonesimulator
else
SF_OTHER_PLATFORM=iphoneos
fi
if [[ "$BUILT_PRODUCTS_DIR" =~ (.*)$SF_SDK_PLATFORM$ ]]
then
SF_OTHER_BUILT_PRODUCTS_DIR="${BASH_REMATCH[1]}${SF_OTHER_PLATFORM}"
else
echo "Could not find platform name from build products directory: $BUILT_PRODUCTS_DIR"
exit 1
fi
# Build the other platform.
xcrun xcodebuild -project "${PROJECT_FILE_PATH}" -target "${TARGET_NAME}" -configuration "${CONFIGURATION}" -sdk ${SF_OTHER_PLATFORM}${SF_SDK_VERSION} BUILD_DIR="${BUILD_DIR}" OBJROOT="${OBJROOT}" BUILD_ROOT="${BUILD_ROOT}" SYMROOT="${SYMROOT}" $ACTION
# Smash the two static libraries into one fat binary and store it in the .framework
xcrun lipo -create "${BUILT_PRODUCTS_DIR}/${SF_EXECUTABLE_PATH}" "${SF_OTHER_BUILT_PRODUCTS_DIR}/${SF_EXECUTABLE_PATH}" -output "${BUILT_PRODUCTS_DIR}/${SF_WRAPPER_NAME}/Versions/A/${SF_TARGET_NAME}"
# Copy the binary to the other architecture folder to have a complete framework in both.
cp -a "${BUILT_PRODUCTS_DIR}/${SF_WRAPPER_NAME}/Versions/A/${SF_TARGET_NAME}" "${SF_OTHER_BUILT_PRODUCTS_DIR}/${SF_WRAPPER_NAME}/Versions/A/${SF_TARGET_NAME}"
重要提示 :
- 你可以在这里修改你的打包生成的Framework的名称
SF_TARGET_NAME=${PROJECT_NAME}
- 你可以修改为
SF_TARGET_NAME=Serenity
- 如果你有使用Cocoapods,你需要编译workspace 而不是project,如果你需要修改workspace相关内容,你可以修改一下脚本代码
xcrun xcodebuild ONLY_ACTIVE_ARCH=NO -workspace "${PROJECT_DIR}/${PROJECT_NAME}.xcworkspace" -scheme "${TARGET_NAME}" -configuration "${CONFIGURATION}" -sdk ${SF_OTHER_PLATFORM}${SF_SDK_VERSION} BUILD_DIR="${BUILD_DIR}" OBJROOT="${OBJROOT}" BUILD_ROOT="${BUILD_ROOT}" SYMROOT="${SYMROOT}" $ACTION
PS : 注意修改workspace setting.修改为legacy build system即可
构建与验证
编译Aggregate.
打开终端
lipo -info /Users/liliguang/...../Serenity.framework/Serenity(文件直接拖到终端)
终端打印信息
Architectures in the fat file: /Users/liliguang/...../Serenity.framework/Serenity are: i386 armv7 x86_64 arm64
需要注意的是: 在这里面编译生成之后是没有包含armv7s, 关于iPhone5,5c的架构是armv7s,我测试过是在iPhone5,5c上运行也是没有问题的.最好也自己测试一下.
Resources and Bundles (资源包)
-
第一步 : 创建Bundle
-
第二步 : 设置Bundle
默认的设置只配置了Mac OS X
修改打包的Bundle Name
-
第三步 : 移除 HIDPI Mac OS X Build 设定
我们创建了一个OS X包,它包括并且选择合并HIDPI(视网膜和non-retina)媒体资源.tiff文件.你不希望这种行为,你需要禁用它,否则你将无法加载映像资产包。
简单来说,你现在加载了Bundle中的资源.同时项目中也可以通过assets中加载.避免冲突.你将所有的资源全部放在Bundle中使用.因为这是给别人使用的内容.
-
给Bundle中添加资源
无论你什么会后添加资源,请选择Bundle
-
第四步 : 添加Bundle到你的Aggregate中
-
第五步 : 读取Bundle资源
// Load the framework bundle.
+ (NSBundle *)frameworkBundle {
static NSBundle* frameworkBundle = nil;
static dispatch_once_t predicate;
dispatch_once(&predicate, ^{
NSString* mainBundlePath = [[NSBundle mainBundle] resourcePath];
NSString* frameworkBundlePath = [mainBundlePath stringByAppendingPathComponent:@"Bundle.bundle"];
frameworkBundle = [NSBundle bundleWithPath:frameworkBundlePath];
});
return frameworkBundle;
}
代码自己简单研究下就可以了.
注意路径正确就好@"Bundle.bundle"
如果你的项目中需要资源. 你在发布的时候,需要将.framework与.bundle一起发给其他开发者.开发者直接拖动这两个文件到他们项目中就可以了...
(这里有个想法,能不能只拖动一个就可以了呢???)
思考其他Framework :
1.需不需要Bundle?也就是有没有相关的登录界面的UI素材?
2.有没有包含资源在一起的Framework创建方式?
我自己对比了一下,其他的SDK,其中也有很多关于Bundle在里面,应该也是和这种方式类似.
也有其他的创建Framework的方式,比如cocoa touch Framework,可以创建静态库和动态库.这种方式适合于纯方法创建.不适合带有UI的Framework. 择优选择吧.
总结
当开发一个框架时,满足你想减少构建时间同时确保你的内容大致匹配你的第三方开发者。我们实现这一平衡,只是构建static library,把static library当做像framework一样使用。
