DTL_RUNPDA

Sommaire

- Utilisation de la base de donnée exportée avec DBeaver

Installation

<<<<<<< HEAD
Pour installer le package
npm install -g dtl_runpda@latest

Note : Le -g est important, le package nécessite d'être installé globalement.

Lors de la première installation, un dossier dtl_runpda est créé dans C:/User/{utilisateur}/, avec à l'intérieur le nécessaire au bon fonctionnement de l'application.
La configuration initiale de l'application est stocké dans un fichier config.json, merci de ne pas le modifier sauf si vous savez ce que vous faites. Ce fichier est regénéré après chaque installation/update du package

Liste des commandes

Note : La fonction run peut aussi être appelée en majuscule, pour le peu que vous ayez créé un alias comme ceci :
`

bash
todo alias run to RUN

alias RUN='run'


$3

Commandes :

bash
run -h
run -H
run -help
run -HELP


Affiche la liste des commandes disponibles et une bref description de leur utilisation.
$3

Commandes :

bash
run -l
run -L
run -list
run -LIST


Affiche la liste des PDA actuellement branchés et détectés par ADB (nécessite son installation en global sur votre pc) en y renseignant le modèle, le numéro de série, la version EasyMobile et la version Android.
!list_pda
$3

Commandes :

bash
run -v
run -V
run -version
run -VERSION


Affiche la version en cours avec le lien vers le changelog.
$3

Commandes :

bash
run -d
run -D
run -default
run -DEFAULT


Permet d'y indiquer un modèle de PDA par défaut. Cette information sera stocké ensuite dans un fichier config.cfg à la racine du dossier, sous la forme KEY=VALUE :

config
DEFAULT_PDA=eda52


Ce paramètre est ensuite utilisé dans chaque module qui nécessite de sélectionner un modèle de PDA.
$3

Commandes :

bash
run -c
run -C
run -clear
run -CLEAR


Permet de clear le cache et les données de l'application EM du PDA sélectionné.
Relance également l'application.
$3

Commandes :

bash
run -u
run -U
run -uninstall
run -UNINSTALL


Désinstalle l'application EM du PDA sélectionné.
$3

Commandes :

bash
run -b
run -B
run -build
run -BUILD


Permet de générer un build APK qu'il soit DEBUG ou RELEASE.
Ne nécessite pas de PDA de branché car il n'installe pas l'apk dans un PDA, il le compile seulement.
$3

Commandes :

bash
run -update


Met à jour l'application plus rapidement qu'en utilisant une commande NPM.
$3

Commandes :

bash
run -e
run -E
run -export
run -EXPORT

Permet d'exporter la base de donnée de l'application EM du PDA sélectionné.
Le module va créer (si ce n'est pas déjà fait) un dossier du nom du modèle du PDA (exemple CT45, EDA52) et va ensuite y insérer le fichier BDD qui a été copié depuis le PDA, en le renomant sous cette forme : MODELE_SERIALNUMBER.

Ce qui permet d'avoir une base de donnée stockée en local PAR pda et non par modèle.

!file_export
L'installation se fait dorénavant avec la commande npm install -g dtl_runpda ou run --update.

Utilisation de la base de donnée exportée avec DBeaver

Le but du module d'export de base de donnée est multiple.

* Pouvoir exporter et < figer > la base de donnée d'un PDA, afin d'y extraire potentiellement des données.
* Pouvoir exporter une base afin de travailler dessus sans utiliser le devtools de chrome, qui pue ces grands mort il faut bien l'avouer.

Le fichier généré ne possède pas d'extensions de fichier, mais c'est un fichier SQLite, ce qui fait qu'on a la possibilité de l'importer dans n'importe quel logiciel de gestion de base de donnée (DBeaver, heidiSQL). Pour le cas de SQLDEVELOPPER, il sera nécessaire d'y installer un plugin afin de gérer la compatibilité avec SQLite.

On va gérer pour l'instant l'importation du fichier depuis le logiciel DBeaver.

1. Click droit dans le navigateur de BDD à gauche puis créer -> Connection.
!dbeaver1

2. Sélectionnez SQLite puis cliquez sur Suivant en bas de la fenêtre.

3. On clique sur Open et on va chercher notre fichier de BDD dans le dossier C:/User/${userName}/dtl_runpda/database/...
Puis on clique sur Terminer en bas.
!dbeaver2

4. Notre base est créé et disponible dans le menu de gauche.
!dbeaver3

$3

Voici un schéma simple d'utilisation.

1. On exporte la base avec la commande run -e puis en sélectionnant le PDA.
2. Notre fichier est désormais stocké en local, on lance DBeaver et on double click sur la connexion afin de la lancer.

Note : Si DBeaver est déjà lancé et qu'on a déjà une connexion active avec la base, il est nécessaire de se déconnecter/reconnecter de la base. Vous pouvez cliquer sur le bouton Rejeter/se reconnecter dans le menu du haut.
!dbeaver4

La nouvelle base écrase la précédente en local mais DBeaver garde encore une trace de l'ancienne version de la base du PDA, il est donc nécessaire d'effectuer cette manipulation.