Initial upload: clavier-ando-mibox

README.md

@@ -0,0 +1,118 @@
+# ClavierAndoMiBox V1
+
+Projet Android contenant deux applications :
+
+- `tv_keyboard` : application Mi Box / Google TV. Elle installe un clavier Android personnalisé et lance un mini serveur HTTP local sur le port `8765`.
+- `phone_remote` : application smartphone Android. Elle envoie le texte vers la Mi Box par Wi-Fi local.
+
+## Chemin recommandé sur ton PC
+
+Copier le dossier extrait ici :
+
+```text
+D:\07-Logiciels\18-ClavierAndoMiBox
+```
+
+## Construction dans Android Studio
+
+1. Ouvrir Android Studio.
+2. `File > Open`.
+3. Choisir :
+
+```text
+D:\07-Logiciels\18-ClavierAndoMiBox
+```
+
+4. Attendre la synchronisation Gradle.
+5. Construire les APKs :
+
+```bash
+./gradlew :tv_keyboard:assembleDebug
+./gradlew :phone_remote:assembleDebug
+```
+
+Sous Windows :
+
+```bat
+gradlew.bat :tv_keyboard:assembleDebug
+gradlew.bat :phone_remote:assembleDebug
+```
+
+Si le wrapper Gradle n'est pas créé, utiliser directement Android Studio :
+
+```text
+Build > Build Bundle(s) / APK(s) > Build APK(s)
+```
+
+## APKs générés
+
+```text
+tv_keyboard\build\outputs\apk\debug\tv_keyboard-debug.apk
+phone_remote\build\outputs\apk\debug\phone_remote-debug.apk
+```
+
+## Installation Mi Box
+
+Depuis le PC :
+
+```bash
+adb connect 192.168.1.56:5555
+adb install -r tv_keyboard\build\outputs\apk\debug\tv_keyboard-debug.apk
+```
+
+Puis sur la Mi Box :
+
+```text
+Paramètres > Système > Clavier > Gérer les claviers
+```
+
+Activer :
+
+```text
+Clavier Ando MiBox
+```
+
+Ensuite, dans une zone de texte, choisir ce clavier comme clavier actif.
+
+## Installation smartphone
+
+Installer :
+
+```text
+phone_remote-debug.apk
+```
+
+Dans l'application smartphone :
+
+```text
+IP : 192.168.1.56
+Port : 8765
+```
+
+Puis écrire un texte et appuyer sur :
+
+```text
+Envoyer le texte
+```
+
+## Test rapide depuis PC
+
+Quand le clavier Mi Box est actif dans une zone texte :
+
+```bash
+curl -X POST http://192.168.1.56:8765/type -d "bonjour"
+curl -X POST http://192.168.1.56:8765/enter
+curl -X POST http://192.168.1.56:8765/backspace
+curl -X POST http://192.168.1.56:8765/ping
+```
+
+## Limite V1
+
+Le texte ne s'injecte que si :
+
+1. le clavier `Clavier Ando MiBox` est actif ;
+2. une zone de texte est ouverte ;
+3. le téléphone et la Mi Box sont sur le même Wi-Fi ;
+4. l'IP de la Mi Box est correcte.
+
+Android ne permet pas à une app ordinaire d'écrire dans les champs texte d'une autre app. D'où le clavier personnalisé, merveilleuse petite acrobatie imposée par le système.