Differences between iOS and Android
There are some differences between iOS and Android that have been imposed on us by the platform:
- 3D carousels are automatically converted to 2D slideshows (Android does not support them)
- Facebook does not let you attach photos or write status messages (this is a Facebook restriction)
- Google requires everyone who wants to use Google Maps on Android to have their own Google Maps v2 API key. You can create your own key at https://code.google.com/apis/console (this is a Google restriction)
There are some differences that are a result of our coding, and we intend to fix them:
- Local beacons are not supported at this time. We hope to add this before final release.
- Loading large images is slow. This will be improved before final Android release.
- PayPal is not supported on Android yet.
There are some differences between iOS and Android that are intentional, because Android and iOS look and work differently and we want to make sure a Beacondo
app feels native on Android rather than feeling like an iOS app that has been copied. For example, tabs in Android work very differently to tabs in iOS,
particularly when there are many of them. We have mimicked the Android behaviour exactly.
How to build an Android app
To configure your app, you should download and install Android Studio. When you run it, it should ask you to update to the latest version. Once you're
ready, you should open your project and:
- Open AndroidManifest.xml, then look for and adjust the lines for your Google Maps API key (if you are using maps), as well as your Beacondo licence
credentials. These lines are clearly marked all in capital letters.
- Configure your app package name. You need to do this with iOS too, but it's a bit more complicated with Android! This is com.beacondo.beacondoapp by default, but needs to be unique when you publish an app to Google Play. You'll find this in AndroidManifest.xml, in app/build.gradle, and in the Java source code - the latter can be changed by right-clicking, choosing Refactor, then choosing Rename. When you're asked whether you want to rename the package or the directory, choose Package.
- When you have built your iOS app using Xcode, to make it work on Android you need to copy the contents of the "Content" directory into the "app/src/main/assets" folder in the Android directory.
- Connect an Android device that has developer mode enabled. This is very well hidden on Android devices! Go to Settings > About Tablet and tap on "Build number" seven times to enable developer mode. You should now be able to press Play straight from Android Studio to push your app to your Android tablet.
Beacondo for Android is still in beta. If you encounter any problems, please email firstname.lastname@example.org and we'll do our best to help. It is usually very helpful if you could make available your application zip file so that we can test the problem locally.
Once you have installed Android Studio, you can download the latest Android beta from here.