Android Office SDK 技术白皮书
目录
一、简介
二、开发环境设定
三、使用示例工程
四、SDK 架构与工作原理
五、正版授权
一、简介
1. 产品简介
Android Office SDK (以下简称 SDK)是一款Android平台的办公文档插件产品。通过集成 SDK,开发者可以在应用中轻易实现查看 Office 文档功能。 SDK 包括以下子产品:
o OfficeSDK-Word For Android
o OfficeSDK-XLS For Android
o OfficeSDK-PPT For Android
o OfficeSDK-PDF For Android
2. 支持格式
SKD 目前支持查看以下 Office 文档格式:
o 电子文档: .doc 或 .docx 及 .txt
o 电子表格: .xls 或 .xlsx
o 演示文稿: .ppt 或 .pptx
o PDF 文档: .pdf
二、开发环境设定
1. 开发所需操作系统:o Windows 7(32/64 位) 或 Windows8(32/64 位)
o Mac OS X 10.5.8 或以上
o Linux 2.6 或以上
2. 开发所需环境:
o JDK 6 或以上
o 及 Android Framework 4.0.3 或以上
3. 开发所需工具:
o Eclipse 3.4 或以上
o Android Studio 1.5 或以上。
三、使用示例工程
在进行开发前,我们先向您展示我们提供的示例工程来增加您对 SDK 的认识。
1. 导入示例工程
我们需要使用开发工具及移动设备来运行示例工程,根据 Android 官方指引,我们向您推荐使用 Android Studio 作为开发使用 SDK 的工具。而较早前因官方已经不再推荐使用 Eclipse,故此文档中不再列出 Eclipse 示例教程,若有需要,请联络技术支持。
在完成上述开发环境设定后,打开 Android Studio 并导入示例工程。该示例工程在Android Studio 3.0 下创建,在其它版本的 AndroidStudio 中可能有兼容性问题。导入工程后,如下图所示:
2.编译执行示例工程
示例工程中的 SDK 库文件可能不是最新的,您需要联络我们的技术支持人员以获取最新的 SDK。请将最上图中 OfficeSDK.jar 替换为最新的 SDK 库文件。此时,整个示例工程已可以在模拟器或移动设备中运行。
示例工程的主界面是一个文件浏览器,该文件浏览器将访问您的移动设备的 SDCARD 目录,并列出所有支持的 Office 文档及文件夹。您可以选择在移动设备上的文件进行查看。注意,由于是示例工程,查看 Office 文档时会显示出我司的水印信息。如下图所示,分别是文件浏览器、查看电子文档、查看电子表格、查看演示文稿:(注:图中按钮作为 SDK 外控件,用于自定义控制 SDK)
四、SDK 架构与工作原理
1. Office 文档格式简介
微软 Office 文档的存储格式主要分为两种:
o Office 97-2003 采用的二进制复合文档格式(简称 03 格式)
o Office 2007 以后的 OpenXML 格式(简称 07 格式)
2. 实现概览
SDK 在设计及实现上遵循 MVC 模式,我们向开发者提供了文档视图及文档控制器以便开发者能够简单地使用 SDK。
2.1. 文档视图:文档视图用于将文档展示给用户,在 SDK 中以DocumentView 作为表示。
DocumentView 相当于 Android 中的自定义控件,其将监听用户的输入及操作,并将计算结果呈现给用户。您可以使用以下代码创建一个DocumentView :
DocumentViewFactory.newWordView(context);
DocumentViewFactory.newSpreadsheetView(context);
DocumentViewFactory.newPresentationView(context);
值得注意的是,目前 SDK 未能支持使用 XML 布局创建文档视图。开发者需要通过判断档格式来创建对应格式的文档视图,在视图创建完成后,将文档视图加入到要显示的容器 View 中即可。
2.2. 文档控制器:文档控制器用于开发者控制文档视图。
在 SDK 中以 DocumentViewController 作为表示。在创建 DocumentView 后,通过以下代码可以获得文档控制器:DocumentView view = …;DocumentViewController controller = view.getController();
获得控制器后,此时可以对整个文档视图进行控制。开发者可以通过以下代码打开 Office 文档:
boolean encrypted = controller.checkEncrypted(…); // 传入文件
if(encrypted) …; /* 处理加密文档 */
else controller.loadFile(…, …); /* 打开文档 */
执行上述代码后, Office 文档将会把文档呈现到文档视图中,此时基本的打开文档操作已经完成。如需要更多的额外操作,也可以在通过文档控制器来完成,如所缩放文档、监听事件等等。更多的操作请查看 Android Office SDK API docs。
五、正版授权
声明:授权文件是我司保护产品的重要文件,为保证您的应用安全,我们倡导使用正版的SDK进行产品开发。
1.获取授权文件
请联络我司的商务部门,您可以从商务部门获取价格、服务支持等等信息。在您完成付款后,授权文件将会交付给开发者。
QQ:635512001
Email:635512001@qq.com
Tel:+86 15071327475
2.导入授权文件
开发者可以通过以下代码将授权信息导入至SDK中:byte[] licenseData = …;
LicenseData.setLicense(licenseData);该代码可以在应用启动时执行或者在打开Office文档时执行,仅首次执行有效。
参考官方网: