Cloud Endpoints Frameworks v1 has been deprecated and will be shut down on August 2, 2018. We recommend that you use the latest version of this feature, which is renamed to Cloud Endpoints Frameworks for App Engine. This new version supports App Engine standard environment, provides lower latency, and has better integration with App Engine. For more details, see Migrating to 2.0.
You can use the Endpoints command line tool to generate client library bundles for Android apps and Google discovery documents.
The Endpoints command line tool can generate a discovery document in either REST format (the default) or RPC format (required for generating an iOS client).
The Endpoints command line tool can be used to generate a Maven client bundle, a Gradle client bundle, or a bundle that contains only the dependency libraries and source jar. If you are using the client library with an Android app, we recommend that you use a Gradle client bundle.
The Endpoints command line tool is provided in the SDK:
Command line syntax for the Endpoints tool
Before you use the Endpoints command line tool, you need to build your backend
project because the tool requires compiled binaries. You can
optionally supply the
--war= option pointing to the build target output directory
WEB-INF/appengine-web.xml file and compiled java classes if you
don't want to use the default (
The basic syntax is as follows:
appengine-java-sdk-x.x.x/bin/endpoints.sh <command> <options> [class-name]
<options>, if supplied, is one or more items shown in the Options table.
[class name]is the full class name of your API.
You can use the following options:
||Lets you specify which type of client bundle should be produced. Specify
||Lets you specify the service class or classes from a path other than the default
||Sets the path to the build target directory
||Sets the directory where the output will be written to.Default: the directory the tool is invoked from.||
Platforms Supported by the Client Bundle
The following are supported in the Java client bundle produced by the Endpoints command line tool:
- Java 5 and higher: standard (SE) and enterprise (EE).
- Android 1.5 and higher.
- Google App Engine.
- The bundle also contains a
readme.htmlfile that provides details on using the client library, which dependent jars are needed for each application type (web, installed, or Android application), and so forth.