WordPress Android

WordPress pour Android

Si vous cherchez simplement à installer WordPress pour Android, vous pouvez le trouver sur Google Play. Si vous êtes un développeur souhaitant contribuer, lisez la suite.

Instructions de construction

1. Assurez-vous d'avoir installé Android Studio.
2. Installez npm à l'aide de Node Version Manager (nvm), comme décrit à la première étape du guide de démarrage rapide de Block Editor.
3. cd WordPress-Android pour entrer dans le répertoire de travail.
4. Dans Android Studio, ouvrez le projet à partir du référentiel local. Cela générera automatiquement local.properties avec l'emplacement du SDK.
5. Recommandé : Le CI utilise JDK11 pour créer l'application et exécuter les tests. Certains tests ne transmettront pas le JDK intégré à Android Studio (JDK8). Vous souhaiterez peut-être définir l'emplacement JAVA_HOME et JDK dans Android Studio sur JDK11.
6. Accédez à Outils → AVD Manager et créez un périphérique émulé.
7. Courir.

Remarques :

• Lors du chargement/de la création de l'application dans Android Studio, ignorez l'invite de mise à jour de la version du plugin Gradle, car cela entraînerait probablement des erreurs de construction. En revanche, n'hésitez pas à mettre à jour si vous envisagez de travailler pour assurer la compatibilité de la version la plus récente.

Construire et tester

Pour créer, installer et tester le projet à partir de la ligne de commande :

 $ ./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

Exécuter l'application

Vous pouvez utiliser votre propre site WordPress pour développer et tester l'application. Si vous n'en avez pas, vous pouvez créer gratuitement un site de test temporaire sur https://jurassic.ninja/. Sur l'écran de démarrage de l'application, choisissez « Entrez l'adresse de votre site existant » et saisissez l'URL de votre site et vos informations d'identification.

Remarque : L'accès aux fonctionnalités de WordPress.com est temporairement désactivé dans l'environnement de développement.

Structure du répertoire

 .
├── 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

Configuration Google

Google Sign-In n'est disponible que pour les comptes WordPress.com via l'application officielle. Les contributeurs peuvent créer et exécuter l'application sans problème, mais la connexion à Google échouera toujours. Google Sign-In nécessite des fichiers de configuration contenant des informations sur le client et le serveur qui ne peuvent pas être partagées publiquement. Plus de documentation et de guides sont disponibles sur le site Web de Google Identity Platform.

Contribuer

Lisez notre Guide de contribution pour en savoir plus sur les problèmes de signalement, la contribution au code et d'autres façons de contribuer.

Sécurité

Si vous découvrez une faille de sécurité, nous vous serions reconnaissants de nous en informer sur https://hackerone.com/automattic et de nous permettre de répondre avant de divulguer le problème publiquement.

Prendre contact

Si vous avez des questions ou si vous souhaitez simplement nous dire bonjour, rejoignez WordPress Slack et déposez un message sur le canal #mobile .

Documentation

• Style de codage – lignes directrices et outils de validation et de formatage automatique
• Directives sur les demandes d'extraction - dénomination des branches et comment rédiger de bonnes demandes d'extraction

Veuillez lire la documentation pour en savoir plus.

Ressources

• Blog mobile WordPress
• Manuel mobile WordPress

Licence

WordPress pour Android est un projet Open Source couvert par la licence publique générale GNU version 2. Remarque : le code du répertoire libs/ provient de bibliothèques externes, qui peuvent être couvertes par une licence différente compatible avec la GPLv2.