2 results

Mobilize Your MongoDB Part IV: Using the Beershift Source Code

During Part 3 of the developing iPhone and Android apps in the cloud series, we went over signing up for a account as well as downloading and deploying the BeerShift backend source code on OpenShift. In this blog post, we will discuss the mobile application code and get it working inside of Titanium Studio. If you haven’t already installed and configured XCode, Titanium Studio, and the Android SDK, please follow the steps outlined in Part 2 of this series. Step 1: Clone the BeerShift project In order to start working with the mobile application for BeerShift, we need a local copy of the open sourced code that is available on github. If you are not familiar with git, we are going to clone the BeerShift repository. This will copy the BeerShift source to our local machine as well as setup a local source code revision control repository that is private. This will enable us to make changes to the source code and commit them to our local private repository. Any change that you commit to BeerShift on your local machine will remain private. If you add some fancy new features, or fix some bugs, you will need to issue a pull request on github in order for the public repository to be updated with your changes. In order to clone the BeerShift source code, open up a terminal window and create a directory for your project. $ mkdir ~/code $ cd ~/code Now that we have a location for our source code, lets clone the BeerShift repository. $ git clone This will create a directory named BeerShift underneath the code directory. To verify that you have the proper source code, lets view some of the commit log. $ cd BeerShift $ git log At this point, you should see the last several contributions to the project. Step 2: Import the project into Titanium Studio Start Titanium Studio and select 'Import Project' on the left hand side of the screen. Select 'Existing Titanium Project' and click 'Next'. Select the location of your source from Step 1, and click on the 'Finish' button. Step 3: Set your deployment targets Now that we have the source code imported into Titanium Studio, we need to set the deployment targets for our application. Double click on the tiapp.xml file that is located under your project directory. If you are on the Mac operating system, and followed all of the steps in Part 2 of this blog series to install XCode and the Android SDK, select iPhone and Android. In you are on Windows or Linux, you will not be able to target iOS devices. Step 4: Understand the directory structure In your 'App Explorer' pane, you should see two top-level directories. The i18n directory is where you can place all of your localization files for your application. Localization in Titanium Studio is pretty straightforward and I will detail how to add the users default locale to your application. Under the i18n directory, you should create a subdirectory for each language / locale that you plan to support (based on the ISO 639-1 standard). For instance, to support both English and German, create two directories: en and de In each locale specific subdirectory, you will need a strings.xml file that is an xml based key->value pair. For example: <?xml version="1.0" encoding="UTF-8"?> <resources> <string name="lblBeerName">Beer Name: </string> <string name="tfBeerName">What am I drinking?</string> <string name="tabDrink">Drink</string> <string name="winDrank">Drank</string> <string name="winFirehose">Keg Stand</string> <string name="tabDrank">Drank</string> <string name="winSettings">Settings</string> <string name="tabFireHouse">Keg Stand</string> <string name="tabSettings">Settings</string> <string name="winDrink">BeerShift</string> <string name="winBeerDetails">Beer Details</string> <string name="lblDrinkTheBeer">Drink It!</string> <string name="lblLoading">Loading......</string> <string name="titleLabelText"> drank </string> <string name="lblApi">URL: </string> <string name="lblApiHintText">Service URL</string> <string name="lblUsername">Username: </string> <string name="tfUsernameHintText">BeerShift Username</string> <string name="lblPassword">Password: </string> <string name="tfPasswordHintText">password</string> <string name="lblAuthenticating">Authenticating</string> <string name="alrtDialogTitle">Bad Password</string> <string name="alrtDialogMsg">Password is not correct for this user</string> <string name="createUserTitle">That user doesn't exist. Would you like to create it?</string> <string name="labelYes">Yes</string> <string name="labelNo">No</string> </resources> These resource files are processed and included in your project at build time. Step 5: Getting started with the source code Expand the 'Resources' directory and double click the app.js file. The app.js file acts like a bootstrap for your application. This is the first file that gets loaded and is where you define and create your layout and application. Instead of walking through the source code in this blog post, check out the video where I walk through the code and explain what is happening. Step 6: Test your application in the simulator Now that we have and understand the source code, lets see it running inside of the iPhone or Android emulator. In order to run the application, select 'Run' and then select 'Run' again. This will open a dialog that will allow you to select which run configuration to use. Once you select your device, Titanium Studio will build your application code and launch the emulator. At this point, you can play around with the application and even set breakpoints and debug inside of the emulator. Step 7: What’s next? You should have the application up and running and hopefully pointed to your own backend hosted on OpenShift. The next step is to add a cool feature or fix a bug that is present in the source code. Once you have modified the code, submit a pull request on github and I will work to get it accepted into the master source code branch. If you haven’t already signed up for OpenShift, take a moment to do that now. Use the promo code ‘BeerShift’ to claim your 3 free applications running on the Red Hat Cloud. Want to see me give a presentation on mobile development? I will be at the following upcoming events: OSCON 2012 - July 17-20 Phoenix PHP Users Group - July 24th Fredricksburg (DC) Linux User Group - July 28 WIP Hackathon, Detroit - July 30-31 MongoDB Toronto - August 2 FOSCON - August 11 MongoDB Charlotte - August 15 NOSQL Now - August 21-23 Want me to come and speak at your users group or conference? Send an email to and we can co-ordinate scheduled. Tagged with: Titanium, objective c, SDK, git, openshift, iphone, android, iphone development, beer, MongoDB, Mongo, NoSQL, Polyglot persistence, 10gen

July 12, 2012

Mobilize Your MongoDB: Building MongoDB Mobile Apps with OpenShift PaaS

This is the first in a 4-part series by Grant Shipley, Cloud Evangelist for Red Hat’s OpenShift Platform-as-a-service. Grant’s series will cover the development of “Beershift”, a mobile app for iPhone and Android built using Titanium, OpenShift and MongoDB. MongoDB makes a great companion to this mobile application given its ability to shard store JSON documents with little data manipulation required. In this blog post, we will go over the background of the application and discuss the features we plan to build. Background: I started developing iOS based applications shortly after the arrival of the iPhone on the market. Having been a Java and PHP developer for my entire career, switching to objective-c was a tough challenge for me. I had to remember basic programming methodologies and patterns that I haven't used since college. It took me nearly two months of work at the cadence of 30-40 hours per week to build my first iOS application. To my delight, after releasing the application, the market for the application was larger that I had anticipated. Users were writing great reviews and requesting more features. Shortly after releasing my first iOS based application, Google decided to enter the smartphone market with their android based sdk and devices. This should have been great news for most software developers but for me, a part time mobile developer, it wasn't. I now had users requesting my application for android devices as well as for the new iPad and other tablets that were hitting the market. I didn't have the free time to port my application to the android sdk as it would have required another two months of software development as well as maintaining two separate code streams for patches and updates. About 8 months ago, I heard about a company called Appcelerator and their Titanium SDK . This SDK would allow me to code using javascript but target native UI controls for an array of devices. This sounded like heaven as most of the applications that I write are productivity or novelty based applications that don't rely heavily on 3D graphics. I set out to learn the titanium SDK and was able to develop the BeerShift sample application over a period of two days. About BeerShift: At OpenShift , we enjoy local craft beers and the social aspects of having a pint while discussing the latest trends in software development and deployment. One night, over a pint, we thought it would be cool if we could quickly read a description of the beer and brewery before ordering. We kept discussing the app and of course feature creep started setting in. By the end of the night, we decided to develop a mobile-based application that would allow a user to search for beers, and then log when and where they drank it. Because the team was split between using iOS and Android based phones, we needed it to work on both devices and sync the information via a backend service. Of course, all of this had to be available via the web as well. This was a great opportunity for me to learn Titanium so I set out to develop the application. The biggest unknown was where to get a freely available database of beers that I could search. I researched this question and did some google searching but didn't really come up with any providers that met my needs. Luckily, while speaking at a PHP Users Group in Raleigh, NC, I met a couple of guys who owned a startup called . With their growing repository of beers and breweries, it had all of the information that I needed in order to develop the sample app. I invited them out for a pint after the user group and we discussed the details. A few days later I had an API key and was ready to get my Titanium Javascript on. Want a quick preview of what we will be building? Check out the video showing the application. BeerShift has a tabbed based UI that consists for 4 main screens. Drink, Drank, Kegstand, and Settings. The settings tab presents the user with username and password input fields. If the username does not exist in the MongoDB database, the user will be prompted if they want to create a new user. The drink tab is the heart of the application. This tab allows the uses to enter in a beer name and will return a result of all beers and breweries that match the search string. The results are retrieved via a REST API call to the openshift server and presented to the user in a table view. The user can select a a beer from the list and then select to ...Drink It“. Once the user has decided to log drinking a beer, the drinking event will be recorded on both the drank tab and the keg stand tab. The keg stand tab will allow the user of the application to view the 50 most recent beers drank by any user of the application. In the next blog post of this series, I will detail the installation of applications and tools needed to begin with development of the BeerShift application. Source Code: All of the source code for this application, including the backend REST API and MongoDBa> integration, is available on Tagged with: red hat, open shift, openshift, mobile, apps, application, titanium, sdk, java, objective c, open source, breweries, beer, brewerydb, MongoDB, Mongo, NoSQL, Polyglot persistence, 10gen

May 15, 2012