AntiGuide:AndroidDesign

20110618
suivant mail ini.txt ... de l'unique lecteur de cette page!

quelques pétitions de principe pour adoucir la programmation "hostile" (1), (2)

00) l'oeuvre est installé dans un dossier initialisé par AndroidMatou (en hommage à la longévité de: http://cp.lakanal.free.fr/chansons/matou.htm ). Le dico poflandais-British de Phm a immédiatement traduit en TomCat (tant pis pour lui qui a mis les deux majuscules).

0) chaque programme est nommé d'UN mot avec initiale majuscule (début des hostilités), sauf matou actuellement:

conforme au new-look:

en cours de ravallement:

La source (le .apk) se trouve sur le serveur http://antiguide.free.fr/apk/##Nom##/bin/##Nom##.apk .

1) géographie du droid: chaque programme a un "home" éponyme chez le sandbox (bac à sable) du matou,
- ce home sera désigné par ~ pour le programme en cours ou ~Nom pour un autre
- le programme s'exécute dans le dossier: ~/memo ) .
- raccourcis pour un nom de fichier (sans tenir compte des permissions), tout se joue sur le début
  - sans chemin: se trouve dans ce dossier work par exemple: /mnt/sdcard/matou/Dormeur/work v&rivier work versus memo
  - ~/ : dans le dossier au nom du programme
  - ~Name/ : dans le dossier au nom du programme Name
  - ~/../ ou ../../ ( ~~/ invention non comptible linux est à oublier! ) dans le dossier /mnt/sdcard/matou
  - / : chemin complet à partir de la racine GAFFE: possible que ça évolue vers la racine de la sdcard ?

GAFFE: au 20110220, les raccourcis ci dessus sont traités a priori sans utiliser les éventuels capacités de linux.
GAFFE: mêmes les noms situés chez le matou (fichier ../../ini.txt sont exploités à partir du dossier work de la tâche en cours;

2) les paramètres sont donnés dans le(s) fichier(s) ini.txt (détails dans AndroidParams)

si un paramètre est présent dans le fichier du home du programme en cours ( ~/ini.txt ), il a priorité
si un paramètre n'existe pas dans le fichier du home, il est recherché chez le matou: ~/../ini.txt soit par exemple: /mnt/sdcard/sandbox/ini.txt

GAFFE: si tasks et/ou externals existent dans le fichier du home, ceux du matou sont ignorés!
COROLLAIRE: pour annihiler tasks et/ou extarnals du matou, coder: task:;externals:;
COROLLAIRE: gaffe à utiliser l'omission comme valeur par défaut, il peut y avoir une valeur chez le matou.

si un paramètre doit s'appliquer seulement à une application, le préfixer ce nom+. par exemple: Dormeur.elapsed:;

si un fichier ini.txt commence par < l'entrée est redirigée depuis le fichier indiqué à la suite (sans ; final!).

(cet élégant trait permet de conserver une bibliothèque de fichiers d'initialisation et de choisir celui à utiliser).
commenter le "commence""" est-ce possible en cours préciser ; à la fin

3) les données "persistantes" sont dans le sous dossier ~/memo ou ~/work
en cas de fin brutale, ces fichiers doivent faciliter une autopsie.

3bis) les informations de trace seront dans le sous dossier ~/trace
en cas de fin brutale, ces fichiers doivent faciliter une autopsie.

3ter) les informations d'erreurs seront dans le sous dossier ~/error
en cas de fin brutale, ces fichiers doivent faciliter une autopsie.

3ter) une erreur fatale ...

4) au lancement du programme est construit un TIMESTAMP (heure GMT ou de paris selon gmt:y;)

5) les données permanentes sont dans un sous dossier " ~/data/timestamp

6) chaque programme produit un fichier log qui reprend les paramètres et toute information utile

8) chacun chez soi et les vaches seront bien gardées:
- a priori un programme ne doit écrire que chez lui (sous son home)

ACTUELLEMENT pas de répression; à terme confinement au bac à sable du matou.

9) l'option shadok:Y; (lire AndroidShadok) (http://fr.wikipedia.org/wiki/Les_Shadoks ) actuellement pour AuLongCours?, plus tard banale, double l'écriture des fichiers.

10) DOUKIVIEN ? : les messages indiquent la source , eventuellement la chaine de "traceback".

11) TAMPONS: (sous la forme alphabétique: YYYYMMDD_HHMMSS )

START_STAMP désigne l'heure de démarrage d'une appli

TIME_STAMP désigne l'heure actuelle

12 bis): les temps sont soit GMT à venir soit heure locale du mobile (à partir de 20120120, fait pour Branleur; à venir pour les autres)

12) Indirections:

dans la rédaction d'un nom de fichier, on peut utiliser une indirection par le contenu d'un autre fichier donné entre []
exemple:
~Branleur/data/[~Branleur/memo/start_time.txt]/[~Branleur/memo/start_time.txt].txt
GAFFE: le nom de fichier est vu depuis le programme client!
pour avoir acces direct à memo: [Branleur:nom (interwiki)] tient pour [~Branleur/memo/nom] et of course [:nom] pour [~/memo/nom]

à faire: moralisation des noms de fichiers: /... racine doit être /mnt/sdcard...

(1): voir "la buche" : http://fr.wikipedia.org/wiki/La_B%C3%BBche
(2) comme écrivait Claude Lévi-Strauss: "je hais les utilisations et les utilisateurs..."; entendez par là que ce chantier doit se passer d'utilisateur et ne rien lui devoir!
(3) ce ~~ n'est pas compatible unix, voir si mieux de prendre un ~/../

AntiGuide: AndroidDesign