This project is no longer actively developed or maintained.

For new work on this check out Mobile Shopping Assistant or Cloud Endpoints.

Mobile Backend Starter Java

This application implements Mobile Backend Starter using Google Cloud Endpoints, App Engine and Java.

Warning: No Longer Supported

The mobile backend starter sample application is no longer supported. If you are looking for an easy way to connect your mobile app to Google Cloud Platform, we recommend you check out Cloud Endpoints. If you are already using the mobile backend starter your code will continue to work and no modifications are necessary at this time.

Copyright

Copyright 2013 Google Inc. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0 lo Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Disclaimer

This is not an official Google Product.

Products

• App Engine

Language

• Java

APIs

• Google Cloud Endpoints

Setup Instructions

You typically need to use this repository only if you want to extend the functionality provided by Mobile Backend Starter (MBS). Otherwise, you can deploy it directly from Google Cloud Platform site by clicking Try It Now.

Requirements

Confirm that your development envoriment fulfills the Requirements of MBS Getting Started doc.

Steps

1. Download MBS backend source code. Click the ZIP button on the MBS backend source code page on GitHub to download the source code package of MBS backend.

2. MBS requires the following jar files which are not included in the source code package above:

   • Download gcm-server.jar file, open Android SDK Manager and choose Extras > Google Cloud Messaging for Android Library. This creates a gcm directory under YOUR_ANDROID_SDK_ROOT/extras/google/ containing "gcm-server/dist" subdirectory which has gcm-server.jar file.

   • Download google-gson-2.1-release.zip and extract the zip file, and you have "google-gson-2.1" directory which has gson-2.1.jar file.

   • Download json-simple.1.1.1.jar file.

   • Download JavaPNS-2.2.jar file.

   • Download common-codec-1.8.jar file.

   • Download bcprov-jdk15on-146.jar file. By default, the downloaded jar file is signed. Execute the following command to unsign this jar file:

     zip -d bcprov-jdk15on-146.jar META-INF/MANIFEST.MF
     

   • Download log4j-1.2.17.jar file.

3. Create a Web Application Project on Eclipse, select New Web Application Project from the Google Plugin for Eclipse. This blue icon is located in the upper left hand corner of your Eclipse client. The New Web Application Project dialog should appear. Enter the followings:

   • Enter Project Name: MobileBackend
   • Enter Package Name: com.google.cloud.backend
   • Deselect "Use Google Web Toolkit" checkbox
   • Deselect "Generate project sample code" checkbox
   • Click Finish

4. Copy the src and war directories to the project. Extract the source code package downloaded at the step 1. Select "src" and "war" directories, copy them, and paste them to the root directory of CloudBackend project on Eclipse.

5. Add the jar files into lib directory. Copy gcm-server.jar, gson-2.1.jar, json-simple.1.1.1.jar, javaPNS-2.2.jar, common-codec-1.8, log4j-1.2.17.jar, and bcprov-jdk5-14.jar (from step 2 to 7) to war/WEB-INF/lib directory. Select the six files and select Build Path > Add to Build Path on right-click menu. This will remove all the errors you have on the Problems tab.

6. Deploy the backend. Edit war/WEB-INF/appengine-web.xml and insert your app id in the "application" element below:

<application>!!! ENTER YOUR APP ID HERE !!!</application>

12. Finally, right-click CloudBackend project and select Google > Deploy to App Engine. This will deploy the backend to your app id. Go through the Getting Starter steps to confirm the backend functions are working properly.