Repository files navigation

This repository contains the source code for theAndroid BootstrapAndroid app available fromGoogle Play.

Please see theissues sectionto report any bugs or feature requests and to see the list of known issues.

Have a questions about Android Bootstrap? Ask away on theandroid-bootstrap discussion forum.

Learn how to develop with IntelliJ and Maven.Watch the how to video

Log into this demo app with the following credentials:

user:demo@androidbootstrap.com

password: android

Why generate? Simple ... renaming files, folders, copy and pasting is SUPER error prone and well... it sucks overall. This can easily take a few days with debugging if you run into issues and perform a lot of typo's. Using the generator onAndroidBootstrap.com you can generate your application with your application name as well as the package (and folder structure) that you want to work with.

As an example, you know that you want your app name and package to the following:

• App Name: Notify
• Package Name: com.notify.app.mobile

After generating the app onAndroidBootstrap.com the folder structure of the source code for the app will change:

• From:com/donnfelker/android/bootstrap
• To:com/notify/app/mobile

At that point all the source files that were located in __com/donnfelker/android/bootstrap will be moved to the new foldercom/notify/app/mobile.

All import statments that reference the old resources (R.com.donnfelker.android.bootstrap.R) will now be renamed to the correct package. The artifact id's in thepom.xml (and various other places) will be replaced. The App Name will be replaced in the strings/etc.

The end result is that you will be given a zip file with the correct structure. Open the zip and then executemvn clean package and your app should be ready for development.

Enjoy!

The application

• Apache Version 2.0

Copyright 2013 Donn Felker

Copyright 2013 GitHub Inc.

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

Unless required by applicable law or agreed to in writing, softwaredistributed 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 andlimitations under the License.

The build requiresMavenv3.0.3+ and theAndroid SDKto be installed in your development environment. In addition you'll need to settheANDROID_HOME environment variable to the location of your SDK:

export ANDROID_HOME=/home/donnfelker/tools/android-sdk

After satisfying those requirements, the build is pretty simple:

• Runmvn clean package from theapp directory to build the APK only
• Runmvn clean install from the root directory to build the app and also runthe integration tests, this requires a connected Android device or runningemulator

You might find that your device doesn't let you install your build if youalready have the version from the Android Market installed. This is standardAndroid security as it it won't let you directly replace an app that's beensigned with a different key. Manually uninstall Android Bootstrap from your device andyou will then be able to install your own built version.

Android Bootstrap is a result of a template project I've developed over the years as well asa combination of a lot of great work that theGitHub Gaug.esapp andGitHub Android app showcased. Some of thecode in this project is based on the GitHub Gaug.es and GitHub Android app.

Android Bootstrap is built on the awesomeParse.com APIand uses many great open-source libraries from the Android dev community:

• ActionBarSherlock for aconsistent, great looking header across all Android platforms,ViewPagerIndicatorfor swiping between fragments andNineOldAndroids forview animations - all fromJake Wharton.
• MenuDrawer for the menu drawer navigation.
• Dagger for dependency-injection.
• ButterKnife for view injection
• Otto as the event bus
• Robotiumfor driving our app during integration tests.
• android-maven-pluginfor automating our build and producing release-ready APKs.
• http-request for interacting withremote HTTP resources (API's in this case).
• google-gson for consuming JSON and hydratingPOJO's for use in the app.

Please fork this repository and contribute back usingpull requests.

Any contributions, large or small, major features, bug fixes, additionallanguage translations, unit/integration tests are welcomed and appreciatedbut will be thoroughly reviewed and discussed.

I hope this helps you in building your next android app.