作者:五指间的节拍 | 来源:互联网 | 2023-10-10 13:23
最近发现国内有的公司提供在线编辑并自动编译生成android应用程序的产品。觉得有点意思,正好有几个朋友老说需要epub格式的电子书,看了看android的SDK,自己业余时间做了个在线生成apk电子书阅读器和epub电子书的程序。近一周没有看电视了,有必要把整个实现过程分享一下,让有需要的朋友有更多的时间看电视。
DEMO地址
(注:目前只支持上传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
step2:将要替换的值放在map里
final HashMap keywords = new HashMap();
keywords.put("ANDROID_APP_NAME",config.getProjectName());
step3:调用installFullPathTemplate方法,覆盖源文件,第一个参数就是你的template文件地址,第二个参数是要生成的源文件,第三个参数就是step2中的map对象
private void installFullPathTemplate(String sourceFilePath, File destFile,Map 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 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。
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。