Tooleap and B4A Part 2: Introduction to Tooleap


This is the first in a series of posts to explain how to use Tooleap with B4A.

You should sign up with their early access / beta program at: tooleap.com . They have very good documentation on site, and great support.

What you will need:

  • B4A 3.80 (may work with earlier version with some limitations)
  • Android SDK 2.2 (Version 8) and above.
  • the tooleap sdk jar (available here or from tooleap.com)
  • the Tooleap Wrapper libraries I wrote available here
  • an API key from Tooleap developers Key Management page to publish/release an app

That is all.

You can make any activity into a TooleapActivity and it can run in either normal mode or in miniApp mode. You can have multiple instances of the same activity in miniApp mode.

The Tooleap Wrapper libraries contain 3 classes:

  • The TooleapManager class. This is used to manage the miniApps and can be used to add, remove or update the miniApps.
  • The TooleapMiniApp class. This is used to initialize and set the properties for the actual miniApp itself. This includes notification properties and app type etc.
  • The TooleapActivityHelper class. This is used with the Activity itself with some useful functions to find out whether the activity is in miniApp more or normal mode, or to find out its AppID.

Testing and Releasing a Tooleap app

You can test a Tooleap app without an API key. In order to do that you have to sign your apk with the debug certificate. In the B4A IDE go to Tools > Private Sign Key, and then select Use debug key at the bottom. You will be able to test the tooleap app, but remember you cannot release your app on the play store with a debug certificate.

For API keys, tooleap is still in early access mode, you first need to join the it using this link: http://developer.tooleap.com/tooleap-registration/

Once you join the program, you should be able to generate API keys. A tooleap API key is related to yourpackage name. To generate your API key go here:  http://developer.tooleap.com/api-keys-management/

Then, put in your package name and it will return an API key for you. This page also lists all your API keys.

Once you have your API key, you need to add this line in your manifest:

AddApplicationText(
<meta-data android:name="com.tooleap.sdk.apiKey" android:value="YOUR-API-KEY-HERE" />)

Also to note some extra information:

  • The Tooleap SDK uses the internet permission. The miniApps have a searchbar (Google) bundled with them that requires this permission and allows users to search google from any miniApp. The SDK may also collect some analytics for further optimizations.
  • TooleapMiniApps at the moment at 80%x and Activity.Height-105dip. I am trying to find out a way to get the width and height after layout is measured, but it is not such a big issue. It is best not to use Dialogs/MsgBoxes with miniApps.