netristv / ti.appcenter

Visual Studio App Center SDK for Axway Titanium

Visual Studio App Center SDK for Axway Titanium

App Center is your continuous integration, delivery and learning solution for iOS and Android apps. Get faster release cycles, higher-quality apps, and the insights to build what users want.

App Center Crashes Module

App Center Crashes will automatically generate a crash log every time your app crashes. The log is first written to the device's storage and when the user starts the app again, the crash report will be sent to App Center. Collecting crashes works for both beta and live apps, i.e. those submitted to the App Store. Crash logs contain valuable information for you to help fix the crash.

App Center Analytics Module

App Center Analytics helps you understand user behavior and customer engagement to improve your app. The SDK automatically captures session count, device properties like model, OS version, etc. You can define your own custom events to measure things that matter to you. All the information captured is available in the App Center portal for you to analyze the data.

Requirements

• Titanium Mobile SDK 9.0.0.GA or later

Building

Update SDK version and its location in ios/titanium.xcconfig if you need.

Run from platform directory (Appcelerator CLI):

appc run -p [android|ios] --build-only

or (Titanium CLI):

ti build -p [android|ios] --build-only

Install

To use your module locally inside an app you can copy the zip file into the app root folder and compile your app. The file will automatically be extracted and copied into the correct modules/ folder.

Project Usage

Add the module as a dependency to your application by editing tiapp.xml. Example:

<modules>
  <module>ru.netris.mobile.appcenter</module>
</modules>

When you run your project, the compiler will combine module along with its dependencies and assets into the application.

Start modules on application create

To start Crashes module on application start edit your tiapp.xml and add property to ti:app tag:

<property name="ti.appcenter.crashes.start-on-create">true</property>

To start Analytics module on application start edit your tiapp.xml and add property to ti:app tag:

<property name="ti.appcenter.analytics.start-on-create">true</property>

You must also define "ti.appcenter.secret.{PLATFORM}" property to be able to run Crashes and/or Analytics modules on application create:

<property name="ti.appcenter.secret.android">{YOUR_APP_SECRET}</property>
<property name="ti.appcenter.secret.ios">{YOUR_APP_SECRET}</property>

Manual modules start

If you need to not start modules on application create you can start them manually later with:

const AppCenter = require('ru.netris.mobile.appcenter');
const {Crashes, Analytics} = AppCenter;
const secret = "YOUR_APP_SECRET"

//  you can't call `start` more then once
AppCenter.start(secret, Crashes, Analytics);

//  when you defined "secret" in properties
//AppCenter.start(Crashes, Analytics);

//  when you need only one service
//AppCenter.start(secret, Crashes);
//  or
//AppCenter.start(secret, Analytics);
//  or
//AppCenter.start(Analytics);

Example Usage

const AppCenter = require('ru.netris.mobile.appcenter');
const {Analytics} = AppCenter;
const secret = "YOUR_APP_SECRET"

AppCenter.start(secret, Analytics);

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' }, function(result) {
    console.log(JSON.stringify(result));
  });

ti.appcenter's Issues

Doesn't work with JDK v11

I had to downgrade from JDK v11 to v10 to get this to work, as the gradle version (4.6) is too old. Gradle version 5.0+ works with JDK v11.

Android build error > A problem occurred starting process 'command ti'

I wasn't able to get the Android module to build, despite following the directions in the README:

JustinsMBP2018:android justintoth$ ./gradlew tiBuild
Starting a Gradle Daemon (subsequent builds will be faster)

FAILURE: Build failed with an exception.

* What went wrong:
A problem occurred evaluating root project 'android'.
> A problem occurred starting process 'command 'ti''

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 15s

Here are the verbose logs: https://gist.github.com/justintoth/2790fc86a2949013727151bde2dd458c

Crashes.trackError

Export trackError to JS: https://docs.microsoft.com/en-us/appcenter/sdk/crashes/android#handled-errors

#3 (comment)