Storyboard Home Screen for Android

All things Storyboard for the Android platform.

Moderator: jamiev

Storyboard Home Screen for Android

Postby thomas » Mon Mar 04, 2013 2:52 pm

Android allows the replacement of the application that is used as a device's home screen.

Any application can become a potential home screen by including the Intent.CATEGORY_HOME
tag in its Manifest.xml file:

<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.HOME" />

When a Storyboard Application is exported to an Android APK package, a default Manifest.xml file is used
to describe the application. In order to change the Intent flags, we want to start with the default Manifest.xml
and then customize it.

Using File > Import > Android Manifest create a copy of the default Manifest.xml file in our project.

Then edit the newly created Manifest.xml file and add the additional intent-filter as indicated above.

All that is left now is to specify that our customized Manifest.xml file should be used when exporting our
Storyboard Application for Android rather than using the default Manifest.xml. This selection is found on
the second page of the Android Storyboard Package exporter under Select Android Manifest File;
uncheck the use of the default file and select the file we edited from the project.

Once your application is installed and subsequently run on an Android device you should get a prompt
indicating that this application is a Home application, asking if you want it to be set as the default.
If you answer yes, then your Storyboard Application will take the place of the current Home application
and run every time you press the home button on your device.

To remove the application as the default, you can go into the settings and either remove the application
or un-mark the default Home application value.


For more information on the CATEGORY_HOME Intent flag see:
Posts: 130
Joined: Mon Nov 02, 2009 4:32 pm
Location: Ottawa

Return to Storyboard for Android

Who is online

Users browsing this forum: No registered users and 4 guests