Messagee is a simple Twitter-style messaging application that leverages the extensive functionality of App services. This section describes some of the features of Messagee.
There are three client versions of Messagee:
Go to https://apigee.com/usergrid/ to access the login screen for the App services admin portal. If you are new to App services, sign up for an account to access the portal, specifying an organization (e.g., the name of your company or project team) and a username and password that you can use to authenticate. Because App services are designed for use by development teams, the same username can be associated with one or more organizations.
If you create a new account, you receive a confirmation email that contains a URL that you must click to activate the account. After this, simply log in to the portal with your username and password.
When you have logged in, you need to create a new application.
- Enter a unique application name. The name must be unique to avoid a conflict with another user running the same application.
- Make sure that the portal shows the application name you entered as the active application beneath the Applications menu (1).
If the correct name is not displayed, click the menu and select your application.
Next, you need to populate a test user user-test-1 that is going to log in to your copy of the server-side Messagee app.
- Click the Users box on the left side of the console (2).
- Click the Add button and enter the user information for your application in the pop-up window (be sure to create a password you can remember), and then click the Create button. Repeat these steps to create a second username test-user-2.
When you have finished all these steps, you have a new application and two new users.
Now that you have created a uniquely named copy of the Messagee application as well as two user accounts (test-user-1 and test-user-2), you are ready to test out the Messagee app. Use test-user-1 to log in to the app, and test-user-2 as the user to follow.
Messagee is available as an iPhone app that uses App services and RestKit. The source for the iOS version of Messagee is available on GitHub at:
Here are the steps to run the Messagee app on iOS:
- Run Steps 1-6 under Creating an app and users.
These steps create a unique instance of the Messagee app on the server and two test users, test-user-1 and test-user-2.
- Access the Messagee server app by typing a URL similar to the following into your iOS mobile client (replace <Messagee> with the unique name of your application):
- On the mobile client, complete the registration information and click Register.
- Log in to the Messagee app by entering the test-user-1 account information created previously, and click the Sign in button.
At this point, the message board is empty:
- To post a message using the app, click the top-right icon in the message board to create a message, write the message text, and send it by clicking Post.
Note: The posted message should appear in the message board within few seconds.
For your instance of the Messagee application to act like Twitter, you need to "follow" another user.
- In the message board, click Add People and add test-user-2 as a person that test-user-1 follows.
- Log in as test-user-2 and post a message as this user to the message board.
- Go back and log in as user test-user-1.
Because test-user-1 follows test-user-2, you should see the message sent by test-user-2 in the message board.
If you want to write iOS applications that connect to App services, you can download the App services iOS SDK at:
Note: The Messagee iOS application uses RestKit, a popular REST framework for iOS, to communicate with App services. Because App services use a REST API, you can use any REST framework to talk with the service. However, the official App services iOS SDK provides a more convenient communication mechanism that you should use unless you're already using RestKit or some other framework in your project.
Messagee is available as a sample Android app that acts as a App services client. The source for the Android version is available on GitHub at:
For writing Android applications, you can use the App services Android SDK at:
Messagee is also available as a sample HTML5 app that behaves in much the same way as the two previous examples. The source for the HTML5 version is available on GitHub at: