Java2OP.exe, le générateur de fichier pont natif pour Android

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilitaires de ligne de commande - Index


Java2OP.exe ("Java vers Object Pascal") est un outil de ligne de commande que vous pouvez utiliser pour générer des fichiers pont natifs Delphi à partir de bibliothèques Java (fichiers JAR ou fichiers de classe). Vous pouvez utiliser les fichiers générés pour autoriser vos applications Delphi à accéder à ces bibliothèques Java sur Android. Voir Utilisation d'un ensemble personnalisé de bibliothèques Java dans vos apps Android RAD Studio.

Java2OP.exe est disponible sur le site des utilisateurs enregistrés : http://cc.embarcadero.com/myreg

Usage

Pour utiliser cet outil, appelez-le simplement avec n'importe quelle combinaison d'options de votre choix :

Java2OP.exe [options]

Vous devez spécifier au moins une option d'entrée qui indique le contenu que vous souhaitez inclure dans le fichier pont natif Delphi de sortie.

Votre fichier pont natif de sortie n'inclut pas les membres qui font partie des bibliothèques Java RAD Studio intégrées pour Android sauf si vous spécifiez explicitement ces membres avec le paramètre -classes. Si l'une des classes que vous avez spécifiées dépend de membres des bibliothèques Java RAD Studio intégrées pour Android, le fichier pont natif résultant ne redéclare pas ces membres. Il inclut à la place les unités RAD Studio qui déclarent déjà ces membres.

Options d'entrée

Option Description

-classes

Liste des noms de classes ou de packages à exporter, séparés par un espace.

-classes vous permet de définir un sous-ensemble spécifique des sources Java spécifiées (options -jar ou -source) ou l'API Android.

-jar

Liste des bibliothèques d'entrée Java compilées, séparées par un espace (fichiers .jar). Tous les membres API des fichiers spécifiés sont analysés et déclarés sur le fichier pont natif résultant.

-source

Liste des dossiers d'entrée contenant des fichiers source Java, séparés par un espace (fichiers .java). Tous les membres API des fichiers des dossiers spécifiés sont analysés et déclarés sur le fichier pont natif résultant.

Options de sortie

Option Description

-unit

Nom de fichier de l'unité de sortie.

Par défaut : Android.JNI.Interfaces

Exemples

Exportation de classes et packages à partir de l'API Android :

Java2OP.exe -classes android.net.ConnectivityManager android.location.*

Exportation de toutes les classes à partir de mylib.jar :

Java2OP.exe -jar mylib.jar

Exportation d'une seule classe à partir de mylib.jar :

Java2OP.exe -jar mylib.jar -classes com.mypackage.ClassName

Exportation de toutes les classes à partir d'un dossier de sources Java en spécifiant le nom de fichier de l'unité Delphi de sortie :

Java2OP.exe -source myproject/src -unit Android.JNI.UnitName

Dépannage

JDK manquant

"JDK manquant. Veuillez installer le JDK 1.7+ ou vérifier qu'il est présent dans votre PATH"

Pour utiliser Java2OP.exe, vous devez installer Java et le JDK 1.7+.

Si vous avez installé le JDK et que vous obtenez cette erreur, il se peut que le dossier binaire du JDK soit introuvable dans les chemins d'accès indiqués dans votre variable d'environnement PATH. Ajoutez le dossier bin de votre répertoire d'installation du JDK à votre PATH.

Par exemple, à partir de la ligne de commande :

SET PATH=%PATH%;C:\Program Files\Java\jdk1.7.0_25\bin

Erreur EListError

"Erreur ListError déclenchée, avec le message  : Doublons non autorisés"

Vous avez spécifié une source ou un fichier JAR plusieurs fois.

Etant donné que Java2OP.exe inclut l'API Android comme entrée par défaut, vous obtenez également cette erreur si vous incluez manuellement le fichier JAR de l'API Android en utilisant l'option -jar. Par exemple, ceci ne fonctionne pas :

Java2OP.exe -jar android.jar

Si vous voulez extraire les membres de l'API Android, spécifiez simplement une option -classes. Par exemple :

Java2OP.exe -classes android.animation.*

Voir aussi