# Android Office SDK技术白皮书

2016年5月

[TOC]

## 简介

1. 产品简介
*Android Office SDK* (以下简称`SDK`)是*武汉织云软件有限公司*旗下产品。通过集成SDK，开发者可以在应用中轻易实现查看Office文档功能。SDK包括以下子产品：
* OfficeSDK-Word For Android
* OfficeSDK-XLS For Android
* OfficeSDK-PPT For Android
* OfficeSDK-PDF For Android

2. 支持格式
SKD目前支持查看以下Office文档格式：
* 电子文档：`.doc` 或 `.docx` 及 `.txt`
* 电子表格：`.xls` 或 `.xlsx`
* 演示文稿：`.ppt` 或 `.pptx`
* PDF文档：`.pdf`

## 开发环境设定
1. 开发所需操作系统：
* Windows 7(32/64位) 或 Windows8(32/64位)
* Mac OS X 10.5.8 或以上
* Linux 2.6 或以上
2. 开发所需环境：
* JDK 6或以上
* 及Android Framework 4.0.3或以上
3. 开发所需工具：
* Eclipse 3.4 或以上
* Android Studio 1.5 或以上。

## 使用示例工程
在进行开发前，我们先向您展示我们提供的示例工程来增加您对SDK的认识。

1. 导入示例工程
我们需要使用开发工具及移动设备来运行示例工程，根据Android官方指引，我们向您推荐使用Android Studio作为开发使用SDK的工具。而较早前因官方已经**不再**推荐使用Eclipse，故此文档中**不再**列出Eclipse示例教程，若有需要，请下载[Eclipse示例工程][eclipse_demo]，导入到Eclipse IDE中，可以编译运行OliveOffice SDK演示文档查看功能。

在完成上述*开发环境设定*后，打开Android Studio并导入示例工程。该示例工程在Android Studio *2.1*下创建，在其它版本的Android Studio中可能有兼容性问题。导入工程后，如下图所示：

![示例工程示意图][demo_image]

2. 编译执行示例工程
示例工程中的SDK库文件可能不是最新的，您需要联络我们的[技术支持][support]人员以获取最新的SDK。请将最上图中 *OfficeSDK.jar* 替换为最新的SDK库文件。此时，整个示例工程已可以在模拟器或移动设备中运行。

示例工程的主界面是一个文件浏览器，该文件浏览器将访问您的移动设备的SDCARD目录，并列出所有支持的Office文档及文件夹。您可以选择在移动设备上的文件进行查看。注意，由于是示例工程，查看Office文档时会显示出我司的水印信息。

如下图所示，分别是文件浏览器、查看电子文档、查看电子表格、查看演示文稿：
（注：图中按钮作为SDK外控件，用于自定义控制SDK）

![示例工程文件浏览器][demo_explorer]![示例工程电子文档][demo_word]![示例工程电子表格][demo_spreadsheet]![示例工程演示文稿][demo_presentation]

## SDK架构与工作原理
1. Office文档格式简介
微软 Office 文档的存储格式主要分为两种：
* Office 97-2003 采用的二进制复合文档格式（简称`03 格式`）
* Office 2007 以后的 OpenXML 格式（简称`07 格式`）

2. 实现概览
![实现概览][sdk_uml]
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. 获取授权文件
请联络我司的商务部门，您可以从商务部门获取价格、服务支持等等信息。在您完成付款后，授权文件将会交付给开发者。

2. 导入授权文件
开发者可以通过以下代码将授权信息导入至SDK中：

	byte[] licenseData = ...;
	LicenseData.setLicense(licenseData);

该代码可以在应用启动时执行或者在打开Office文档时执行，仅首次执行有效。

[support]: mailto:[e-mail] "技术支持"
[eclipse_demo]: https://pan.baidu.com/s/1i4THBrZ "Eclipse示例工程"
[demo_image]: https://i.imgur.com/OR1mw5h.png "示例工程示意图"
[demo_explorer]: https://i.imgur.com/MVnU6Ni.png "示例工程文件浏览器"
[demo_word]: https://i.imgur.com/KY9CjYq.png "示例工程WORD"
[demo_spreadsheet]: https://i.imgur.com/cTmqp1W.png "示例工程SPREADSHEET"
[demo_presentation]: https://i.imgur.com/RdHkvaM.png "示例工程PRESENTATION"
[sdk_uml]: https://i.imgur.com/6Y4WSJj.png "SDK MVC"