This document explains how to build and run the demo of the Java version of libphonenumber, from the command line on Linux or Mac, using Google App Engine. By following the instructions here, you can build a demo running against any revision of the Java code by supplying jar files you build on your own, or downloading the ones from Maven Central.
Download and follow the
instructions to install the Java
SDK of Google App Engine. This document assumes it is named as
appengine-java-sdk. You may want to rename the directory after unpacking.
Check out the Java code:
git clone https://github.com/googlei18n/libphonenumber.git
Create a symlink to your unpacked appengine sdk directory at the same level as
the java directory. Alternatively, update java/demo/build.xml to point to
the right location for the appengine sdk.
Save the libphonenumber, geocoder, carrier, and prefixmapper jars under
demo/war/WEB-INF/lib/.
You can either download them from the Maven repository or build them yourself by running:
git clone https://github.com/google/libphonenumber.git
cd libphonenumber/java
ant jar
cp build/jar/* demo/war/WEB-INF/lib
Start the server:
cd demo
ant runserver
This will start a server on your localhost, and you can try it out by pointing your browser to http://localhost:8080/.
If you get a warning from App Engine asking you to upgrade your JRE to Java 1.6
or later, you might need to install Java 1.6 and point your JAVA_HOME to it.
- To see your current
JAVA_HOME, runecho $JAVA_HOME. - To see the list of JDKs currently installed, use
update-java-alternatives -l. - To reset
JAVA_HOME, useexport JAVA_HOME=[path to Java 1.6 SDK]/jre.
Now run ant runserver to start the server on your localhost.
If you want to upload the demo to your own App Engine application, follow the steps to register an application with App Engine.
Then run:
../appengine-java-sdk/bin/appcfg.sh update war
The demo will be uploaded to http://application-id.appspot.com/.