B4A : (Newbie) Créer une Bibliothèque de fonctions pas à pas (create a library)

La bibliothèque est un objet “CODE” réutilisable dans n’importe quel projet, comme n’importe quel Objet, sans être obligé de recopier ou d’importer les routines qu’elle contient.

Elle peut servir aussi simplement à rendre en le compilant, un Module illisible pour protéger ses codes.

Créer une librairie à partir de B4A est extrêmement simple et consiste à compiler 2 fichiers  (JAR et XML) à l’aide du menu dédié.

Exemple : 
Créer une Bibliothèque INI contenant 
les routines de gestion d'un fichier de configuration

Voir ces routines ...

Ouvrir B4A

PARAMETRAGE PREREQUIS

OUTILS

• Configurer les chemins
  • Définir un dossier Windows ou sont rangés les Bibliothèques Additionnelles
  • Ce paramétrage se fait une fois pour toutes

CREER UNE BIBLIOTHEQUE

Un bibliothèque se créer comme n’importe quel projet

• Fichier
  • Nouveau
    • Défaut

Dans MAIN 

• Ouvrir la Zone #Region Project Attributes 
  • Et remplacer les lignes par défaut par celles ci

#Region Project Attributes 
  #LibraryName: JC_INI
  #LibraryAuthor: BlueGYN
  #LibraryVersion: 1.0
#End Region

• ATTENTION : Pas d’espace entre # le nom et : et respecter la casse
  1. # LIBRARY NAME : (pas bon)
  2. #LibraryName: (correct)

Ces lignes vont servir à générer le fichier XML de Bibliothèque

Dans PROJET

• Ajouter (ou importer) un nouveau module
  • de code
    • Nommer le par exemple :

JC_INI

• Ecrire les fonctions Sub  INI avec un code valide comme dans n’importe quel module
• Le mieux est d’importer un module INI.BAS indépendant qui fonctionne déjà dans un projet stable (Le but est de pouvoir se resservir de son module pour tous les autres projets sans réécrire de code)

COMPILER

PROJET

• Compiler en Bibliothèque (ALT+5)

2 fichiers sont générés dans le dossier AdditionalLibraries

• JC_INI.JAR
• JC_INI.XML

UTILISER LA BIBLIOTHEQUE DANS UN PROJET

FENETRES

• Gestionnaire de Bibliothèques
  • Cocher INI

Appeler une fonction de la Bibliothèque INI

• ATTENTION la fonction de bibliothèque est préfixée par le Nom du Module et non celui de la bibliothèque.
• Par exemple pour appeler  la fonction  GetSTR dans le Module INI de la Bibliothèque INILIB
  • INILIB.GetSTR = Erreur
  • INI.GetSTR = Correct

EXCLUSIONS

Pour exclure un module de la compilation (s’il en existe plusieurs), rajouter la directive dans le module à exclure

#ExcludeFromLibrary: True

NB  Le module MAIN est toujours EXCLU par défaut (si le module INI est unique, l’exclusion est facultative

• Visiter B4A
• Image par Gerhard G. de Pixabay