今天在新自制framework时,遇到两个坑,记录一下,关于framework的制作可以参考其他文章;
背景:在现有workspace中集成三方库,workspace中含有三个project,其中有2个static library的project,和一个主工程。主工程依赖2个static输出的framework结果,在每次主工程build时,都会对依赖的library project进build,得到最新的framework。现在新增一个project并设置成static library,命名为xxxFW。其他辅助库依赖该库的输出结果。
坑1:新增framework被引用后,但是在workspace build时未进行build,且在引用库的头文件时找不到头文件;
解决方式:1. 未进行build ---》因为在我的workspace只有一个Executable对象,即默认scheme中的主工程,而其他scheme是其他辅助framework的,且辅助framework设置成static library的,所以他自身并没有主动编译的能力,需要由其他trigger进行被动触发。 而我的项目中是在辅助static library project中对xxxFW进行了引用,未在主工程中进行引用。所以现在要解决问题就很简单了,只需要在主工程中的build phases - link binary with libraries 中添加xxxFW.framework既可对xxxFW进行编译了;2. 找不到头文件---》在xxxFW project中将其输出结果重定向到指定的目录下,如主工程的Frameworks目录下,然后在辅助库中引入主工程下的库文件即可。在build setting -> build locations -> Pre-configuration Build Products Path
中进行重定向设置。
坑2:自制framework成功后,在使用时引用库中头文件报警告“Missing Submodule”。
简书上有一篇《制作Framework中的警告“Missing Submodule” warning》对这个问题的解决,但是我觉得说的不是很清楚,我就在作者的基础上润色一下,望作者不怪。
关于stackflow这段
I ran into the same problem and eventually fixed it by adding my project headers into the umbrella header. When you create a new framework it should start with a single .h file titled by the project (in your case DirectProximityFramework.h).
Inside this file is a comment:
In this header, you should import all the public headers of your framework using statements like #import <DirectProximityFramework/PublicHeader.h>
So just add your GeofencingHelper.h file in this file:
#import <DirectProximityFramework/GeofencingHelper.h>
This should remove all of your warnings!
说的很对,也应该是xcode的设计思路。我理解的意思是,1. 自制framework相当于是将功能子模块化,2. 在报Missing Submodule
时,只需要将要暴露出去的头文件全部引入到以framework project同名的umbrella header
--xxxFW.h
中即可消除警告。正如引文中提到一样,在以framework project同名的umbrella header
头文件中有一句提示:In this header, you should import all the public headers of your framework using statements like #import <xxxFW/PublicHeader.h>
,即要将所有要暴露的头文件统统引到该头文件,并且格式为#import <xxxFW/PublicHeader.h>
。而推荐做法应该不是在pch文件中引入头文件,因为xxxFW中默认没有.pch文件,当然xxxFW.h
文件从其他的维度上看有pch的功能,但是有一定的误导性。
当时我在看完as_one的文章时并不是很明白,不过还是提醒了我,所以我在umbrella header
中引入了所有头文件后,警告也就消除了。
所以,xcode中模板生成的提示还是很有必要看的,正如前面说的,as_one的文章之所以提示我是因为在创建framework时我有留意过xcode的提示,但当时觉得没有必要引入,只要将需要暴露的头文件配置成public就好了,结果躺了这么一个坑。