PageTurner 技术文档

1. 安装指南

安装 Java

在 Ubuntu 上，您可以使用以下命令安装 OpenJDK 8：

sudo apt-get install openjdk-8-jdk

在 Windows 上，请从 Oracle 官方网站 下载并安装 JDK。

安装 Android SDK

1. 从 Android 开发者网站 下载 Android SDK。
2. 解压下载的 SDK。
3. 使用以下命令更新 SDK：

sdk/tools/android update sdk --no-ui

在 Ubuntu 上，安装 ia32-libs：

apt-get install ia32-libs

4. 将 sdk/tools/ 和 sdk/platform-tools 添加到您的系统路径。

安装 USB 驱动

确保 adb devices 命令可以列出您的设备。

配置系统路径

在 .bashrc 文件中添加以下内容：

export ANDROID_HOME=$HOME/projects/adt-bundle-linux/sdk/
if [ $(uname -m) == 'x86_64' ]; then
    export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64/jre
else
    export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-i386/jre
fi

PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

使用 Gradle

PageTurner 现在使用 Gradle 构建系统，而不是 Maven。如果想要使用本地 Gradle 版本，确保其版本至少为 2.1。建议使用 Gradle Wrapper，它会自动下载正确的 Gradle 版本到您的系统。

运行 Gradle Wrapper：

gradlew

构建并安装 PageTurner

一切准备就绪后，可以使用以下命令构建 PageTurner 并安装到您的设备上：

gradlew build
gradlew installDebug

在 Eclipse 中构建

注意： 不推荐在 Eclipse 中构建 PageTurner。建议使用 IntelliJ IDEA 社区版，它能够自动导入 Maven 项目。

如果要在 Eclipse 中构建，可以使用 m2e-android 插件或手动配置 Maven 依赖。

2. 项目使用说明

PageTurner 是一个免费、开源的电子书阅读器，支持在多个设备之间同步阅读进度。您可以在手机上阅读几页，然后切换到平板电脑继续阅读。

3. 项目 API 使用文档

PageTurner 使用基于 JSON 的后端服务来自动同步阅读进度，该服务将进度点存储在数据库中。项目提供了一个可用的同步服务 api.pageturner-reader.org，但需要访问密钥才能使用。

访问密钥可以通过向项目捐赠或贡献代码、翻译等方式获得。如果您希望运行自己的同步服务，可以在 GitHub 上的 PageTurnerWeb 项目中找到相关代码。

4. 项目安装方式

请按照以下步骤构建并安装 PageTurner：

1. 确保已安装 Java 和 Android SDK。
2. 运行 Gradle Wrapper 下载所需的 Gradle 版本。
3. 使用 gradlew build 构建项目。
4. 使用 gradlew installDebug 将构建的应用到您的设备上。

通过以上步骤，您应该能够成功安装并使用 PageTurner。