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配置

Google 登入僅可透過官方應用程式用於 WordPress.com 帳戶。貢獻者可以毫無問題地建立和運行應用程序，但 Google 登入總是會失敗。 Google 登入需要包含無法公開分享的用戶端和伺服器資訊的設定檔。更多文件和指南可以在 Google Identity Platform 網站上找到。

貢獻

閱讀我們的貢獻指南，了解報告問題、貢獻程式碼以及更多貢獻方式。

安全

如果您碰巧發現安全漏洞，請透過 https://hackerone.com/automattic 告知我們，並允許我們在公開揭露問題之前做出回應。

取得聯繫

如果您有疑問或只是想打個招呼，請加入 WordPress Slack 並在#mobile頻道上留言。

文件

• 編碼風格 - 指南、驗證和自動格式化工具
• 拉取請求指南 - 分支命名以及如何編寫好的拉取請求

請閱讀文件以了解更多資訊。

資源

• WordPress 行動部落格
• WordPress 移動手冊

執照

適用於 Android 的 WordPress 是一個受 GNU 通用公共授權版本libs/保護的開源專案。