最近发现国内有的公司提供在线编辑并自动编译生成android应用程序的产品。觉得有点意思,正好有几个朋友老说需要epub格式的电子书,看了看android的SDK,自己业余时间做了个在线生成apk电子书阅读器和epub电子书的程序。近一周没有看电视了,有必要把整个实现过程分享一下,让有需要的朋友有更多的时间看电视。
(注:目前只支持上传docx和epub格式的文件, 支持epub是因为朋友需要为已经有的电子书加上封面图片,以及其他信息,如果你需要,可以试试。
目前在搜狗浏览器上效果不佳,懒得改了,这浏览器太多还真是个挺操蛋的问题。)
图示效果:
之前写了篇博客,windows下用command创建编译打包android工程,要自动生成apk,无非在编译打包之前要准备好源代码,并且源代码中的部分参数的值是用户在网页上提交的。所以整个过程的流程可以简要概括为以下几步:
1. 准备要生成的应用程序源代码
2. 挑选出源代码中需要定制的源文件(.java)
3. 根据用户在网页上输入的参数,替换源文件中的关键字
4. 编译工程,生成未签名的apk
6. 为apk签名
7. zipalign优化已签名的apk
8. 生成下载链接,并根据链接地址生成二维码供手机用户下载。
下面详细描述一下各个步骤的实现方式:
1. 准备要生成的应用程序源代码(我挑选了FBReader 开源电子书阅读器,整个阅读器的效率还是不错的,占用资源小,不像有的电子书,实现了翻页的效果,但是翻页效果很卡(我用的是galaxy s3,,机器配置应该还算是不错))
下载FBReader的源代码后,假设我们需要对FBReader进行如下的小定制:
1. 将FBReader的名称替换为自定义的名称,包括进入程序的显示名称和生成的apk名称
2. 第一次进入APK打开的是自定义的电子书
APK的工程名称是在android工程中,根目录下AndroidManifest.xml文件中定义的,同样,FBReader的程序的名称(在手机中安装后显示的名字),也是在AndroidManifest.xml文件中定义。
所以,第一步要解决如何替换源文件中的名称了,实现方式很简单,直接贴代码:
step1:新建AndroidManifest.xml.template文件,将文件中要修改的字段用特殊名称标注,比如我将android:label的值替换为ANDROID_APP_NAME
<activity android:name="org.geometerplus.android.fbreader.FBReader" android:launchMode="singleTask" android:icon="@drawable/fbreader" android:label="ANDROID_APP_NAME" android:theme="@style/FBReader.Activity" android:configChanges="orientation|keyboardHidden|screenSize">
step2:将要替换的值放在map里
final HashMap<String, String> keywords = new HashMap<String, String>();
keywords.put("ANDROID_APP_NAME",config.getProjectName());
step3:调用installFullPathTemplate方法,覆盖源文件,第一个参数就是你的template文件地址,第二个参数是要生成的源文件,第三个参数就是step2中的map对象
private void installFullPathTemplate(String sourceFilePath, File destFile,
Map<String, String> placeholderMap) {
try {
BufferedWriter out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(destFile),"UTF-8"));
BufferedReader in = new BufferedReader(new InputStreamReader(new FileInputStream(sourceFilePath),"UTF-8"));
String line;
while ((line = in.readLine()) != null) {
if (placeholderMap != null) {
for (Map.Entry<String, String> entry : placeholderMap.entrySet()) {
line = line.replace(entry.getKey(), entry.getValue());
}
}
out.write(line);
out.newLine();
}
out.close();
in.close();
} catch (Exception e) {
}
}
要让FBReader初次进入的时候打开的是自定义的书籍,修改一个方法即可,在FBReader的源代码中查找BookUtil.java中的getHelpFile()方法,FBReader第一次加载的时候,会打开帮助文档,在哪里调用的呢,是在FBReaderApp.java中的openBookInternal()方法中,
//book = Collection.getBookByFile(BookUtil.getHelpFile());
book = Collection.getBookByFile(BookUtil.getUserUploadFile());
我们添加自己的方法getUserUploadFile(),在第一次阅读的时候,将我们定义在assets中的epub书籍拷贝到sdcard的书籍目录下。为什么要有这么多次一举的拷贝呢?原因有两个:
1. 因为在assets里的不支持中文名的文件,如果assets文件夹中有中文,在编译阶段,会报错,不支持中文。
2. 放在assets里的epub在FBReader中不能显示封面信息,只能显示书籍内容,如果你不介意这个,可以不用拷贝到sdcard中,注意不要使用中文名哦。
public static ZLFile getUserUploadFile(){
ZLFile srcFile = ZLResourceFile.createFileByPath("data/book/mybook.epub");
boolean isSrcExist = srcFile.exists();
if(isSrcExist){
String bookDir = checkSdCardBookFolder();
if(bookDir.trim().length() > 1){
String destPath = bookDir+File.separator+"mybook.epub";
try {
copyEpubToSdCard(srcFile.getInputStream(), destPath);
FileUtils.del("data/book/");
} catch (IOException e) {
return srcFile;
}
return ZLResourceFile.createFileByPath(destPath);
}else{
return srcFile;
}
}else{
return getHelpFile();
}
}
private static String checkSdCardBookFolder(){
String sdDir = "";
boolean sdCardExist = Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED);
if(sdCardExist){
sdDir = Environment.getExternalStorageDirectory().getPath();//获取跟目录
if(sdDir.endsWith(File.separator)){
sdDir += "Books";
}else{
sdDir += File.separator + "Books";
}
File bookDir = new File(sdDir);
if(!bookDir.exists()){
bookDir.mkdir();
}
}
return sdDir;
}
源文件准备好了,下一步就可以编译源码,生成apk并签名和优化了,之前的文章中windows下用command创建编译打包android工程已经介绍了关键工具的使用,那么这次就需要自动完成,所以用ant就可以完成这个工作了,编辑FBReader中的build.xml文件,替换机制和上面说的相同,主要是介绍一下要在各个已有工程中的build.xml添加哪些打包相关的target.
step1. 在build.properties文件中准备好使用参数,主要是签名密码,sdk的路径,jdk的路劲
android.tools=${sdk.folder}tools
android_version=4.2.2
apk.sdk.home=ANDROID_SDK_HOME
apk.tools=${apk.sdk.home}tools
jdk.home=JDK_HOME
password=123456
step2:在build.xml中添加打包相关的target。
<?xml version="1.0" encoding="UTF-8"?>
<project name="ANDROID_APP_NAME" default="help">
<loadproperties srcFile="local.properties" />
<property file="ant.properties" />
<property file="build.properties" />
<loadproperties srcFile="project.properties" />
<loadproperties srcFile="local.properties" />
<!-- quick check on sdk.dir -->
<fail
message="sdk.dir is missing. Make sure to generate local.properties using 'android update project'"
unless="sdk.dir"
/>
<property name="outdir" value="bin" />
<property name="out-unsigned-package" value="${outdir}/${ant.project.name}-release-unsigned.apk" />
<property name="out-signed-package" value="${outdir}/${ant.project.name}-release-signed.apk" />
<condition property="zipalign-package-ospath" value="${basedir}/${outdir}/ANDROID_APP_NAME_for_android_${android_version}_${temp.dir}.apk" else="${basedir}/${output.dir}">
<os family="windows" />
</condition>
<condition property="keytool" value="${jdk.home}/bin/keytool.exe" else="${jdk.home}/bin/keytool.exe">
<os family="windows" />
</condition>
<condition property="zipalign" value="${apk.tools}/zipalign.exe" else="${apk.tools}/zipalign">
<os family="windows" />
</condition>
<condition property="jarsigner" value="${jdk.home}/bin/jarsigner.exe" else="${jdk.home}/bin/jarsigner">
<os family="windows" />
</condition>
<condition property="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" else="${basedir}/${out-unsigned-package}">
<os family="windows" />
</condition>
<condition property="out-signed-package-ospath" value="${basedir}/${out-signed-package}" else="${basedir}/${out-signed-package}">
<os family="windows" />
</condition>
<import file="${sdk.dir}/tools/ant/build.xml" />
<target name="keytool" depends="release">
<if>
<condition>
<not>
<resourceexists>
<file file="${outdir}/keystore.store"/>
</resourceexists>
</not>
</condition>
<then>
<exec executable="${keytool}" failοnerrοr="true">
<arg value="-genkey" />
<arg value="-v" />
<arg value="-alias" />
<arg value="puma-alias" />
<arg value="-keyalg" />
<arg value="RSA" />
<arg value="-keysize" />
<arg value="2048" />
<arg value="-validity" />
<arg value="10000" />
<arg value="-keystore" />
<arg value="${outdir}/keystore.store" />
<arg value="-keypass" />
<arg value="${password}" />
<arg value="-storepass" />
<arg value="${password}" />
<arg value="-dname" />
<arg value="CN=puma,OU=cn,O=cn,L=cn,ST=cn,C=cn" />
</exec>
</then>
<!--else>
<fail message="keyfile already exist." />
</else-->
</if>
</target>
<target name="jarsigner" depends="keytool">
<exec executable="${jarsigner}" failοnerrοr="true">
<arg value="-verbose" />
<arg value="-keypass" />
<arg value="${password}" />
<arg value="-storepass" />
<arg value="${password}" />
<arg value="-sigalg" />
<arg value="MD5withRSA" />
<arg value="-digestalg" />
<arg value="SHA1" />
<arg value="-keystore" />
<arg value="${outdir}/keystore.store" />
<arg value="-signedjar" />
<arg value="${out-signed-package}" />
<arg value="${out-unsigned-package}" />
<arg value="puma-alias" />
</exec>
</target>
<target name="zipalign" depends="jarsigner">
<exec executable="${zipalign}" failοnerrοr="true">
<arg value="-v" />
<arg value="-f" />
<arg value="4" />
<arg value="${out-signed-package-ospath}" />
<arg value="${zipalign-package-ospath}" />
</exec>
</target>
</project>
step3. 在程序中调用ant api执行这个build.xml中的zipalign target就可以生成签好名的apk了
import org.apache.tools.ant.Project;
import org.apache.tools.ant.ProjectHelper;
private void releaseProject(String projectSrcDir) throws Exception {
Project project = new Project();
project.init();
String _buildFile = new String(projectSrcDir + File.separator + "build.xml");
ProjectHelper.configureProject(project, new File(_buildFile));
if (project == null)
throw new Exception("No target can be launched because the project has not been initialized. Please call the 'init' method first !");
String _target = "zipalign";
project.executeTarget(_target);
}
OK,apk就这么生成了,sdk提供的工具还是蛮强大的。
至于如何将docx转换成epub,目前比较好的开源项目有adobe提供的EPUBGen,这个工程支持rtf2epub, word2epub, fb2epub等格式的转换,考虑到大家用word比较多,就之用了word2epub了。使用方法很简单:
ConversionService service = (ConversionService) it.next();
if(service.canConvert(srcFile)){
StringWriter log = new StringWriter();
PrintWriter plog = new PrintWriter(log);
destFile = service.convert(srcFile, null, this, plog);
}
如何修改已有epub的书籍信息,可以使用 epublib类库,该类库提供了EpubReader和EpubWritter。可以使用该类库将txt或者其他文本类型的文件转成epub,嫌麻烦,就没有做了。毕竟txt中不支持图片,docx文件中可以添加自己喜欢的图片,还是比较好用的。
以上就是做这个转换工具使用的一些方法,如果你看到了,希望对你有所帮助!
JUST DO IT。