Creating your own Baker Android Project

To create your own baker application for an Android environment you have compile the library and then create your own project in Android Studio. The following will guide you through the process:

Prerequisites

• Android Studio installed Home Page
• Maven Build Tool Home Page

Compiling Baker Frameworks

1. Download Baker Frameworks to your local environment (download here).
2. From Console/Terminal (for Unix Systems) or CMD for Windows go to the "ABakerProject" folder. (if you list the files you should be able to see "gradlew").
3. Run "gradlew install" command, if you are running on Windows it should go like this "gradlew.bat install" otherwise use "./gradlew install". NOTE: if you ran through "Testing Baker Android" previously to this guide, before doing 'gradlew install' make sure you revert the line apply plugin: 'android' to apply plugin: 'android-library' to avoid any issues.

If this last step ran correctly you should see something like this

BUILD SUCCESSFUL
Total time: 21.441 secs

It means that Baker Frameworks for Android was installed as a library in your Maven repository wich will allow you to use it in you own project.

Creating your own Baker Android project

1. Open Android Studio and click "New Project...".

2. Add your applications details and click "Next".

3. Use "Blank Activity" and click "Next".

4. You can use the default values for Activities, click "Finish".

5. On the project view, extend your module node and open the "build.gradle" file. Notice is not the project but the node build file.

6. Add your local maven repository url to below the apply statement, should look like this:

   apply plugin: 'android'
   repositories {
       maven {
           url 'file://' + new File(System.getProperty('user.home'), '.m2/repository').absolutePath
       }
   }
   

7. Add the Android Baker Library to the compile dependencies

   compile 'com.baker:ABaker:1.1'
   

8. Update the "minSdkVersion" to 11.

9. Update the "targetSdkVersion" to 17.

10. From the Android Baker Library "src/main" folder copy the "AndroidManifest.xml" file and replace the one on your project module.

11. Replace the package name on the manifest definition with the package name of your project.

12. Go to your file "mgzn/src/main/java/com/undrrpblc/mgzn/MainActivity.java", if exist, delete all code inside the class to look like this.

    <package name>
    import ...
    public class MainActivity extends <some super class> { 
    } 
    

13. From the Android Baker Library Project copy the assets and res folder to the same location in you own Project main module.

14. Allow it to Overwrite all.

15. On "res/values/strings.xml" you will find the URLs and properties you can override to make your project use your own servers.

16. On "res/drawable-*/" you will find the images to replace for the application Icon. Make sure you use the same sizes when replacing them.

17. On "res/layout/magazine_thumb_options.xml" you will find the values for colours, fonts and sizes of the main shelf view (list of issues).

18. On "assets" you will find the html files that renders the Background of the Main shelf view, the Header and the Loading Screen. Make sure you create responsive html pages for you app so it renders correctly in all devices.

Possible issues

Could not find com.google.android.gms:play-services

1. Open your Android Studio
2. Go to menu Tools > Android > SDK Manager
3. Extend "Extras" node and check Google Play Services
4. Click on install packages..