简介
J2Objc算是一个Xcode的"插件",其本质是一个命令行命令工具,在Xcode编译期间将目标位置的Java源代码生成对应的Objc代码,这样在Objc代码中则可以直接调用Java的代码。我们只需维护Java代码,就可以做到一份代码两端使用的效果,当然J2Objc不直接iOS UI方面的转换,谷歌团队相信涉及到UI控件的时候,在不同平台使用自己原生的控件是体验最好的,后续谷歌团队也没有支持UI代码转换的打算,所以J2Objc所转换的代码是业务逻辑方面的代码。
就iOS而言,我们使用MVC架构的话,则不利于使用J2Objc,因为Controller不仅有业务代码,同时也有UIKit框架下的组件,这样一是这个文件不利于跨平台,二是这样耦合在一起后不利于做纯业务方面的单元测试。所以不管是iOS还是Android,我们不使用MVC架构设计。我们可以使用MVVM或者MVP,至于是VM还是P,在我看来差别都不大,都是一个"View Coordinator"(感谢Dave Lee提的这个 “View Coordinator” 术语)。引用一下一篇CocoaChina文章中对于VM、P的比喻:
什么是VM、P ?
你可以认为它就像是电视新闻主播背后的研究人员和作家团队。它从必要的资源(数据库, 网络服务调用, 等)中获取原始数据, 运用逻辑, 并处理成 view (controller) 的展示数据. 它(通常通过属性)暴露给视图控制器需要知道的仅关于显示视图工作的信息(理想地你不会暴漏你的 data-model 对象)。 它还负责对上游数据的修改(比如更新模型/数据库, API POST 调用)。
至于函数响应式编程或者是面向抽象的设计等理念,在这里就不展开,下面还是回到这篇文章的主旨来好。
准备工作
1.JDK1.8或者1.8以上。如果当前系统的JDK版本是1.8以下,可以自行下载一个1.8版本安装,多个版本的JDK是可以共存的,点击这里可以看如何在MAC上切换多个JDK版本。
2.了解Xcode中xcconfig配置文件的作用和使用,目的是避免配置路径的时候写死了,这个多人合作就会回到找不到目标资源的错误。效果和我们平时使用${PROJECT_DIR}这个环境变量表示工程根目录类似,关于xcconfig方面的信息可以看小编另外一边文章xcconfig配置文件的使用。
开始集成
首先我们先看J2Objc的几种集成方法介绍
这里介绍了三种方法
- 创建一个外部工程,存放Java源代码,这样的优点是支持Java Tool,类似IDE,可以支持对Java源码的检查和重构。
- 将Java源代码存放到工程目录下,这样做的优点是方面项目调试、分析。
- 将J2Objc的 JreEmulation集成到Xcode中,这样是高度集成,既方便项目调试,又让Xcode可以设置对Java编译的多种选项,灵活度提高。
接下去本文介绍第二种集成方法,从字面上了解看来,第三种方法是最灵活的,这里不做介绍,因为太过于麻烦,去年配了小编两天的时间。如果使用第二种方法,除去下载时间,配置和解Bug用不了一个小时。所以我们直接看第二种集成方法。
集成步奏
- 新建一个Xcode项目,写一个Java文件,例如:
package com.example.mango.myapplication;
/**
* Created by mango on 2017/12/13.
*/
public class Loog {
public static void print(String content) {
System.out.printf("print content:%s%n", content);
}
}
然后将其拖拽到建好的Xcode项目下,我则在根目录创建了一个名为JavaSource的文件夹存放Java源码,结果可以参考图一。
- 在build settings的Other Linker Flags中添加一个值-ljre_emul,如图二所示,图中其它的值请先忽略。
2.下载J2Objc的zip包并且解压,下载地址,下载后小编则直接将解压后的文件夹拖拽到Library目录下。 新建两个xcconfig文件。内容参考如下,路径为你下载的J2Objc文件夹的根路径。
J2OBJC_HOME = /Users/mango/Library/j2objc-2.0.5
# 上面的/Users/mango/Library/j2objc-2.0.5是小编自己的J2Objc文件夹路径,你的路径不一定和我一样,除非你的user名字也叫做mango哈哈哈哈哈。
文件创建、设置等可以查看小编另外一篇文章xcconfig配置文件的使用
-
点击顶部工具类最右侧的"+"号,在弹出菜单中选择Add User-Defined Setting。设置Key值为J2OBJC_HOME,值为${J2OBJC_HOME},也就是我们在xcconfig中设置的环境变量。操作如图三
在 Search Paths目录修改以下选项的值:
- 为Framework Search Paths 添加 ${J2OBJC_HOME}/frameworks
- 为Library Search Paths 添加 ${J2OBJC_HOME}/lib
- 为User Header Search Paths 添加 ${J2OBJC_HOME}/include
如图四所示:
添加Build Rule
- 点击Build Rules菜单项,然后点击"+"增加一个编译规则,Process选项选择Java source files,Using选项选择默认的Custom script。填入脚本如下:
if [ ! -f "${J2OBJC_HOME}/j2objc" ]; then echo "J2OBJC_HOME is not correctly defined, currently set to '${J2OBJC_HOME}'"; exit 1; fi;
"${J2OBJC_HOME}/j2objc" -d ${DERIVED_FILES_DIR} -sourcepath "$source-root" --no-package-directories -g ${INPUT_FILE_PATH};
其中的source-root**为你的Java源码的根目录,比如图一所示,我的Java源码所在的文件夹根目录是JavaSource,所以这里我的**source-root则替换成${PROJECT_DIR}/CocoaPodsTest/JavaSource。
注意
上面的脚本是谷歌推荐的脚本,谷歌认为使用 MRC 是一种比较好的方式,所以上面的脚本最终生成的是 MRC 版本的 OC 文件,相信现在绝大部分的工程使用的是 ARC 吧,所以我们需要生成 ARC 的 OC 文件,为了达到这个效果,我们使用-use-arc
参数。
其次,为了避免类名冲突,转换完毕之后的类是以包名作为前缀,所以有时候会显得过分得长,为此我们可以指定前缀,指定前缀说明.
因此,新的脚本命令内容如下:
if [ ! -f "${J2OBJC_HOME}/j2objc" ]; then echo "J2OBJC_HOME is not correctly defined, currently set to '${J2OBJC_HOME}'"; exit 1; fi;
"${J2OBJC_HOME}/j2objc" -d ${DERIVED_FILES_DIR} -sourcepath "${PROJECT_DIR}/AirportBase/JavaSource" --no-package-directories -use-arc --prefix com.example.mango.*=MM -g ${INPUT_FILE_PATH};
- 在下边的Output Files面板中,点击 + 按钮,添加{DERIVED_FILES_DIR}/{INPUT_FILE_BASE}.h,再点击 + 按钮,添加{DERIVED_FILES_DIR}/{INPUT_FILE_BASE}.m
完整的过程如图五所示:
初步配置完毕,编译一下
-
编译完毕,出现如图六失败信息
没什么问题,小编google了一下,搜索内容为""_iconv_open", referenced from: j2objc",结果google出来的结果第一个链接,最后一楼让我们添加一个链接库选项-liconv,如图七所示
重新编译,成功。
-
如果我是基于一个cocoaPods生成的项目,则除了图六的失败信息,还有如图八的失败信息
参考上面的错误,我们知道这也是一个库没有链接成功导致的错误,所以解决办法依然是google搜索错误信息,比如"_inflateSetDictionary", referenced from: j2objc",在出现的第二个链接中楼主遇到的错误和我们的一样,14个错误信息,一毛一样,楼下也有人说明了需要链接到压缩包库,添加-lz这一个选项,参照图七的步奏,添加完毕之后,重新编译,完美无错。
- 如果出现其它错误,有了上面1.2的解决步骤,聪明的你一定可以解决。
如果本文有什么地方有错,还请各位看官不吝指出,谢谢。