README.md

Cannonball for Android

Cannonball is the fun way to create and share stories and poems on your phone. Start with a beautiful image from the gallery, then choose words about #romance, #adventure, or #mystery to complete the story and share it with friends. Browse top stories created by other users for inspiration.

If you just want to use the app, install it at Google Play Store.

Fabric

This is a canonical sample Android app to demonstrate how to use Fabric kits on your mobile apps.

On this app you will find the following Fabric features:

Fabric initialization

Can be found at App onCreate method

Twitter Kit

• Sign in with Twitter at LoginActivity
• Search Embedded Timeline at PoemPopularActivity
• Share at PoemHistoryActivity
• Digits at LoginActivity

Mopub Kit

• Native Ads at PoemHistoryActivity

Crashlytics Kit

Crashlytics custom logging is spread all around the code, just search for "Crashlytics" in the source code.

• Crash Reporting
• Custom logging (custom keys, user information, caught exceptions)
• Beta
• Answers

Building

If you want to run the app locally, do the following:

1. Import the project in your IDE (we use gradle to build)
2. If you don't have a Fabric account
   1. Sign up at fabric.io
   2. Install Fabric IDE plugin
   3. Rename app/crashlytics.properties.sample to app/crashlytics.properties
   4. Fill in your keys there
3. If you have a Fabric account
   1. Rename app/crashlytics.properties.sample to app/crashlytics.properties
   2. Fill in your keys there
4. For MoPub, you need to sign up and generate a Ad Unit id.
5. Add that id to app/crashlytics.properties
6. Run it

See how to integrate the SDK if you need more help.

Get support

If you need support to build the app or to understand any part of the code, let us know. Post your question at Twitter Community forum.

Contributing

The goal of this project is to be an example for Fabric and we strive to keep it simple. We definitely welcome improvements and fixes, but we may not merge every pull request suggested by the community.

The rules for contributing are available at CONTRIBUTING.md file.

Contributors

• Luis Cipriani
• Gareth Jones
• Israel Camacho
• Ty Smith
• Lien Mamitsuka
• Andre Pinter
• Chris Aniszczyk
• Eric Frohnhoefer
• Michael Furtak
• Steve Wilber
• Dalton Hubble

License

Copyright 2015 Twitter, Inc and other contributors.

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0