Utiliser Protocol Buffers

Voici un exemple rapide montrant comment inclure des tampons de protocole dans votre projet.

Voici une définition de tampon de protocole simple, geo.proto:

syntax = "proto2";

message Location {
  optional string name = 1;
  optional double latitude = 2;
  optional double longitude = 3;
}

Et notre programme Java principal, Hello.java :

class Hello {
  public static void main(String[] args) {
    Geo.Location.Builder locationBuilder = Geo.Location.newBuilder();
    locationBuilder.setName("CN Tower");
    locationBuilder.setLatitude(43.6412172);
    locationBuilder.setLongitude(-79.3884058);
    Geo.Location location = locationBuilder.build();
    System.out.println(location.toString());
  }
}

Tout d'abord, une petite configuration de "projet" :

export J2OBJC_HOME=~/j2objc    # Change to where the j2objc distribution was unzipped.
ls $J2OBJC_HOME/j2objc         # Fix above definition until this command works.
mkdir java objc classes        # Output directories

Ensuite, utilisez j2objc_protoc pour générer les tampons de protocole. Générez du code Java avec --java_out et du code Objective-C avec --j2objc_out. La valeur spécifiée avec chaque option correspond au répertoire de sortie pour la langue cible. Les deux langages de sortie peuvent être générés dans la même commande.

$J2OBJC_HOME/j2objc_protoc --java_out=java --j2objc_out=objc geo.proto
ls java
Geo.java
ls objc
Geo.h Geo.m

Les fichiers proto Java générés doivent être compilés afin que les références à ceux-ci dans Hello soient résolues. Cette opération s'effectue à l'aide de javac. Par conséquent, elles ne sont pas traduites en objectif C à l'étape suivante.

javac -source 1.8 -target 1.8 -bootclasspath $J2OBJC_HOME/lib/jre_emul.jar -cp $J2OBJC_HOME/lib/protobuf_runtime.jar -d classes java/*.java
ls classes/
Geo$1.class                 Geo$Location$Builder.class  Geo$LocationOrBuilder.class
Geo$Location$1.class        Geo$Location.class          Geo.class

Traduisez les sources Java comme d'habitude, en ajoutant les protos Java compilés au paramètre "classpath".

$J2OBJC_HOME/j2objc -cp classes:$J2OBJC_HOME/lib/protobuf_runtime.jar -d objc Hello.java
ls objc
Geo.h   Geo.m   Hello.h Hello.m

Toutes nos sources Objective-C doivent maintenant être compilées et associées. Vous devrez créer un lien avec la bibliothèque libprotobuf_runtime.a pour inclure l'environnement d'exécution protobuf.

$J2OBJC_HOME/j2objcc -lprotobuf_runtime -o hello objc/*.m
./hello Hello
name: "CN Tower"
latitude: 43.6412
longitude: -79.3884