WordPress Android

适用于 Android 的 WordPress

如果您只是想安装 Android 版 WordPress，可以在 Google Play 上找到它。如果您是想要做出贡献的开发人员，请继续阅读。

构建说明

1. 确保您已安装 Android Studio。
2. 使用节点版本管理器 (nvm) 安装 npm，如块编辑器快速入门指南的第一步中所述
3. cd WordPress-Android进入工作目录。
4. 在 Android Studio 中，从本地存储库打开项目。这将自动生成带有 SDK 位置的local.properties 。
5. 推荐：CI 使用 JDK11 构建应用程序并运行测试。某些测试无法通过 Android Studio 中嵌入的 JDK (JDK8)。您可能需要将 Android Studio 中的 JAVA_HOME 和 JDK 位置设置为 JDK11。
6. 转到“工具”→“AVD 管理器”并创建一个模拟设备。
7. 跑步。

笔记：

• 在 Android Studio 中加载/构建应用程序时，请忽略更新 Gradle 插件版本的提示，因为这可能会引入构建错误。另一方面，如果您打算努力确保新版本的兼容性，请随时更新。

构建和测试

要从命令行构建、安装和测试项目：

 $ ./gradlew assembleWordPressVanillaDebug                        # assemble the debug .apk
$ ./gradlew installWordPressVanillaDebug                         # install the debug .apk if you have an
                                                                 # emulator or an Android device connected
$ ./gradlew :WordPress:testWordPressVanillaDebugUnitTest         # assemble, install and run unit tests
$ ./gradlew :WordPress:connectedWordPressVanillaDebugAndroidTest # assemble, install and run Android tests

运行应用程序

您可以使用自己的 WordPress 网站来开发和测试该应用程序。如果您没有，可以在 https://jurassic.ninja/ 免费创建一个临时测试站点。在应用程序启动屏幕上，选择“输入您现有的站点地址”，然后输入您的站点的 URL 和您的凭据。

注意：在开发环境中暂时禁用对 WordPress.com 功能的访问。

目录结构

 .
├── libs                    # dependencies used to build debug variants
├── tools                   # script collection
├── gradle.properties       # properties imported by the build script
├── WordPress
│   |-- build.gradle        # main build script
│   └── src
│       ├── androidTest     # Android test assets, resources and code
│       ├── test            # Unit tests
│       ├── main
│       │   ├── assets      # main project assets
│       │   ├── java        # main project java code
│       │   └── res         # main project resources
│       ├── debug           # debug variant
│       └── wasabi          # wasabi variant specific resources and manifest

谷歌配置

Google 登录仅可通过官方应用程序用于 WordPress.com 帐户。贡献者可以毫无问题地构建和运行应用程序，但 Google 登录总是会失败。 Google 登录需要包含无法公开共享的客户端和服务器信息的配置文件。更多文档和指南可以在 Google Identity Platform 网站上找到。

贡献

阅读我们的贡献指南，了解报告问题、贡献代码以及更多贡献方式。

安全

如果您碰巧发现安全漏洞，请通过 https://hackerone.com/automattic 告知我们，并允许我们在公开披露问题之前做出回应。

取得联系

如果您有疑问或只是想打个招呼，请加入 WordPress Slack 并在#mobile频道上留言。

文档

• 编码风格 - 指南、验证和自动格式化工具
• 拉取请求指南 - 分支命名以及如何编写好的拉取请求

请阅读文档了解更多信息。

资源

• WordPress 移动博客
• WordPress 移动手册

执照

适用于 Android 的 WordPress 是一个受 GNU 通用公共许可证版本 2 保护的开源项目。 注意： libs/目录中的代码来自外部库，这些库可能受与 GPLv2 兼容的不同许可证的保护。