Quickstart

Follow below steps to integrate Terra with your project

Create your product in Terra Console#

Create and configure your app on Terra Console (the site is under construction so please contact us, we will do it for you)

Installation#

Firstly please refer to Teko repository access guide for instruction to setup the environment.

When the environment is ready, add the below code to import Terra:

Android
iOS
Javascript
Flutter

Using Gradle

Add to your project's build.gradle.kts

implement("vn.teko.terra:terra-core-android:$version")

Using CocoaPods

Add Terra pod to your Podfile

pod 'Terra', '~> [version]'

flutter pub add terra_flutter

For detail installation, please refer Terra installation

Configuration#

Configuration file is required to initialize Terra. To create this file please refer to Create configuration file

Initialize TerraApp#

Android
iOS
Javascript
Flutter

Initialize TerraApp when your Application starts

var terraApp: TerraApp? = null

terraApp = TerraApp.initializeApp(
    application = application,
    appName = "vnshop"
)

appName parameter is your Product Code
application parameter is the Application instance

In AppDelegate, call TerraApp.configure method to create an instance of TerraApp with config from terra api.

import Terra
import TerraInstancesManager

var terraApp: ITerraApp!

TerraApp.configure(appName: "vnshop", bundleId: "vn.teko.ios.vnshop") {
    (isSuccess, terraApp) in
    self.terraApp = terraApp
}

appName parameter is your Product Code
bundleId parameter helps Xcode choose the right TerraService-Info.plist file in case there are more than one bundle.

import Terra, { TerraConfig } from '@terra-js/app';

await Terra.initializeApp({
    appName: "vnshop",
    terraConfig: {
        terraClientID: 'vnshop:android:playstore:1.0.0',
        terraEnvironment: 'live'
    }
});

appName parameter is your Product Code
terraConfig defines which configuration to be used for this app

import 'package:terra_flutter/terra_app.dart';

final terra = await TerraApp.initTerraApp(appName: appName);

appName parameter is your Product Code

Get the TerraApp instance#

TerraApp is used to access various Terra features, to get its instance use:

Android
iOS
Javascript
Flutter

val terraApp: TerraApp = TerraApp.getInstance(appName = "vnshop")

appName parameter is your Product Code

import Terra from '@terra-js/app';

const appName = "vnshop"
const terraApp = Terra.getApp(appName);

appName parameter is your Product Code

import 'package:terra_flutter/terra_app.dart';

final terraApp = TerraApp.getInstance(appName);

appName parameter is your Product Code

At this point Terra is successfully setup!