Instabug plugin from Smartface
Instabug plugin
Instabug is an in-app feedback and bug reporting tool for mobile apps. With just a simple shake, your users or beta testers can report bugs or send in-app feedback and the SDK will capture an environment snapshot of your user's device including all console logs, server-side network requests and bug reproduction steps compiling all these details in one organised dashboard to help you debug and fix bugs faster.
Installation
Smartface Instabug plugin can be installed via npm easily from our public npm repository. The installation is straightforward via the Smartface Cloud IDE.
- Run command
(cd ~/workspace/scripts && npm i -S sf-plugin-instabug)
iOS
- Add Instabug plugin config to config/project.json under build/input/ios/plugins.
"instabugios": {
"url": "",
"path": "plugins/iOS/instabugios.zip",
"active": true
}
- If your app doesn’t readily access the microphone or the photo library, you will need to add the following keys to the config/iOS/info.plist file of your app for permissions required by Instabug.
<key>NSMicrophoneUsageDescription</key>
<string>Need microphone access for uploading videos</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Need Library access for uploading images</string>
How to use
- You can initialize the SDK by calling the .build(token,invocationEvent) in app.js file.
const InstaBug = require("sf-plugin-instabug");
InstaBug.build("TOKEN",InstaBug.InvocationEvent.SHAKE);
Invocation Events
You can set the Instabug interface to be shown by using one of the following methods:
- Shake device
- Take a screenshot
- Tap on a floating button shown above the UI of your app
- Do a 2-finger swipe from right to left
To customize the invocation event, pass one of the values of the InstaBug.InvocationEvent enum when starting the SDK.
InstaBug.InvocationEvent.NONE
InstaBug.InvocationEvent.SHAKE
InstaBug.InvocationEvent.FLOATING_BUTTON
InstaBug.InvocationEvent.SCREENSHOT_GESTURE
InstaBug.InvocationEvent.TWO_FINGER_SWIPE_LEFT
Shaking Threshold
If you are using the shaking gesture as your invocation event you can control the shaking treshold to activate Instabug. The values in the following example are the default ones. The higher the value the less sensitive the device will be to shaking; thus to the invocation.
var shakingThreshold = {
android : 350,
iphone : 2.5,
ipad : 0.6
}
InstaBug.setShakingThreshold(shakingThreshold);
Manual Invocation
If you want to invoke the SDK manually, use the invoke method.
InstaBug.invoke();
Alternatively, instead of showing the default menu that lets the users choose what they want to do, you can invoke the Instabug interface with a specific feature. In this case, the "How can we help you?" popup will not appear.
InstaBug.invokeWithInvocationMode(InstaBug.InvocationMode.NEW_BUG);
Below are the available invocation modes:
InstaBug.InvocationMode.NEW_BUG
InstaBug.InvocationMode.NEW_FEEDBACK
InstaBug.InvocationMode.NEW_CHAT
InstaBug.InvocationMode.CHATS_LIST
The following method dismisses all visible Instabug views:
InstaBug.dismiss();
Color Theme
The Instabug interface has 2 color themes: light and dark. You can set which theme to use with the following method.
InstaBug.setTheme(InstaBug.Theme.DARK);
Below are the available themes:
InstaBug.Theme.LIGHT
InstaBug.Theme.DARK
Primary Color
You can also set the color of the interactive UI elements or call to action to match your app.
InstaBug.setPrimaryColor(Color.WHITE);
Introductory
To show an intro message to guide users on how to use Instabug.
InstaBug.showIntroMessage();
Prompt Options
When the user invokes the SDK with any of the previously discussed gestures, the prompt options popup appears. By default, it shows all the enabled features. You have control on which options are allowed and which are not by disabling and enabling any of the features. Each one can be enabled or disabled separately.
InstaBug.setPromptOptionsEnabled(true,true,true);
When only a single option is enabled, it becomes the default invocation mode. If all options are disabled, bug reporting becomes the default invocation mode.
Language
The SDK will automatically use the device's current locale, however, you can override it with the following method
InstaBug.setLocale(InstaBug.Locale.English);
Below are the possible locale values:
InstaBug.Locale.Arabic;
InstaBug.Locale.ChineseSimplified;
InstaBug.Locale.ChineseTaiwan;
InstaBug.Locale.ChineseTraditional;
InstaBug.Locale.Czech;
InstaBug.Locale.Danish;
InstaBug.Locale.Dutch;
InstaBug.Locale.English;
InstaBug.Locale.French;
InstaBug.Locale.German;
InstaBug.Locale.Italian;
InstaBug.Locale.Japanese;
InstaBug.Locale.Korean;
InstaBug.Locale.Norwegian;
InstaBug.Locale.Polish;
InstaBug.Locale.Portugese;
InstaBug.Locale.PortugueseBrazil;
InstaBug.Locale.Russian;
InstaBug.Locale.Slovak;
InstaBug.Locale.Spanish;
InstaBug.Locale.Swedish;
InstaBug.Locale.Turkish;
User Email and Name
By default, Instabug prompts the user to enter their email in a report. You can set the email as a required or an optional field:
InstaBug.identifyUser("NAME","EMAIL");
User Attributes
You can assign custom attributes to your users and they will show up on your Instabug dashboard with each report. Those attributes can later be used to filter the reports in the dashboard.
To add a new user attribute, use the following method:
InstaBug.setUserAttribute("Age","18");
You can also remove the current value of a certain user attribute:
InstaBug.removeUserAttribute("Age");
And retrieve user attributes:
InstaBug.getUserAttribute("Age");
InstaBug.getAllUserAttributes();
Logout
When a user logs out, the following method should be used.
InstaBug.logoutUser();
Calling logoutUser will reset the value of the email and name previously set. It will also remove any currently set user attributes, events, chats and data.
License
This project is licensed under the terms of the MIT license. See the LICENSE file. Within the scope of this license, all modifications to the source code, regardless of the fact that it is used commercially or not, shall be committed as a contribution back to this repository.