Visual Studio App Center

To add AppCenter to your React Native project, follow these steps:

1. Add the RudderStack-App Center module to your app as shown:

npm install @rudderstack/rudder-integration-appcenter-react-native
## OR ##
yarn add @rudderstack/rudder-integration-appcenter-react-native

Make sure the minSdkVersion of your build.gradle in the root of android directory is atleast 21

import rudderClient from "@rudderstack/rudder-sdk-react-native"
import appcenter from "@rudderstack/rudder-integration-appcenter-react-native"

const config = {
  dataPlaneUrl: DATA_PLANE_URL,
  trackAppLifecycleEvents: true,
  withFactories: [appcenter],
}
rudderClient.setup(WRITE_KEY, config)

Follow the below steps to add App Center to your Flutter Project:

1. Add the following dependency to the dependencies section of your pubspec.yaml file.

rudder_integration_appcenter_flutter: ^1.1.1

2. Run the below command to install the dependency added in the above step:

flutter pub get

3. Import the RudderIntegrationAppcenterFlutter in your application where you are initializing the SDK.

import 'package:rudder_integration_appcenter_flutter/rudder_integration_appcenter_flutter.dart';

4. Finally, change the initialization of your RudderClient as shown:

final RudderController rudderClient = RudderController.instance;
RudderConfigBuilder builder = RudderConfigBuilder();
builder.withFactory(RudderIntegrationAppcenterFlutter());
rudderClient.initialize(<write_key>, config: builder.build(), options: null);

For Android platform, make sure that the android.defaultConfig.minSdkVersion is set to atleast 21 by checking it in the android/app/build.gradle file.

For iOS platform, you can link App Center as a framework instead of a library with your application by linking it statically as shown below:

ruby Copy

use_frameworks! :linkage=> :static

To add App Center to your Cordova project, follow these steps:

1. Navigate to the root folder of your application and run the following command::

cordova plugin add rudder-integration-appcenter-cordova

2. Add the platforms that you want to target for your app:

cordova platform add ios
cordova platform add android

3. Run the following command to build the project for all platforms:

cordova build

4. Add the following code in the onDeviceReady() function of your home page to initialize the SDK:

RudderClient.initialize(WRITE_KEY , {
  dataPlaneUrl: DATA_PLANE_URL,
  factories: [RudderAppCenterFactory]
})

Make sure to use the await keyword with the initialize call.

Your Android project must be on version 5.0 (API level 21) or higher for RudderStack to be able to send events to App Center.

Once confirmed, follow these steps to add App Center to your Android project:

1. Add the following dependencies to your app/build.gradle file as shown:

implementation 'com.rudderstack.android.sdk:core:1.7+'
implementation 'com.rudderstack.android.integration:appcenter:1.+'
implementation 'com.google.code.gson:gson:2.8.6'

2. Also add the App Center analytics depedencies to your app/build.gradle as shown below:

def appCenterSdkVersion = '4.1.0'
implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"

3. Make sure that the minSdkVersion in your app/build.gradle is atleast 21.

defaultConfig {
  minSdkVersion 21
}

4. Finally, change the initialization of your RudderClient in your Application class:

// initializing Rudder SDK
val rudderClient =
    RudderClient.getInstance(
        this,
        WRITE_KEY,
        RudderConfig.Builder()
            .withDataPlaneUrl(DATA_PLANE_URL)
            .withFactory(AppcenterIntegrationFactory.FACTORY)
            .build()
    )

Follow these steps to add App Center to your iOS project:

5. Go to your Podfile and add the Rudder-AppCenter extension

pod 'Rudder-AppCenter'

6. After adding the dependency followed by pod install , you can add the imports to your AppDelegate.m file:

#import <rudderappcenterfactory.h>

7. Finally, change the initialization of your RudderClient as shown:

RSConfigBuilder *builder = [[RSConfigBuilder alloc] init];
[builder withDataPlaneUrl:<your_data_plane_url>];
[builder withFactory:[RudderAppCenterFactory instance]];
[RSClient getInstance:<your_write_key> config:[builder build]];

To use App Center, your iOS project must be set up in Xcode 11 or later on macOS version 10.14.4 or later. Also, you must be targeting devices running on iOS 9.0 or later.

This device mode integration is supported for App Center v4.4.1 and above.

1. Install RudderAppCenter (available through CocoaPods) by adding the following line to your Podfile:

pod 'RudderAppCenter', '~> 1.0.0'

2. Run the pod install command.
3. Next, import the SDK depending on your preferred platform:

@import RudderAppCenter;

import RudderAppCenter

4. Next, add the imports to your AppDelegate file under didFinishLaunchingWithOptions method:

RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
[config dataPlaneURL:DATA_PLANE_URL];

[[RSClient sharedInstance] configureWith:config];
[[RSClient sharedInstance] addDestination:[[RudderAppCenterDestination alloc] init]];

let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
            .dataPlaneURL(DATA_PLANE_URL)

RSClient.sharedInstance().configure(with: config)
RSClient.sharedInstance().addDestination(RudderAppCenterDestination())

Firstly import the AppCenterIntegrationFactory as shown below:

import {
  enableAnalytics,
  disableAnalytics,
} from '@rudderstack/rudder-integration-appcenter-react-native';

Then add the below script just after the initalization of the React Native SDK:

• To enable App Center Analytics:

await rudderClient.registerCallback("App Center", () => {
  enableAnalytics();
});

• To disable App Center Analytics:

await rudderClient.registerCallback("App Center", () => {
  disableAnalytics();
});

Firstly import Appcenter’s Analytics Module as shown below: groovy import com.microsoft.appcenter.analytics.Analytics;

Then add the below script just after the initialization of the Android (Java) SDKAndroid (Java) refers to the legacy RudderStack Android SDK. Note that it will be deprecated soon.

For new implementations, use the Android (Kotlin) SDK instead. :

rudderClient.onIntegrationReady("App Center") {
    // have your own logic to get the user consent
    if (userConsent) {
        // enabling appcenter's analytics module
        Analytics.setEnabled(true)
    } else {
        // disabling appcenter's analytics module
        Analytics.setEnabled(false)
    }
}

Firstly import the Appcenter’s Analytics Module as shown below:

@import AppCenterAnalytics;

Then add the below script just after the initialization of the iOS (Obj-C) SDKiOS (Obj-C) refers to the legacy RudderStack iOS SDK. Note that it will be deprecated soon.

For new implementations, use the iOS (Swift) SDK instead. :

if(userConsent)
{
    // enabling appcenter's analytics module
    [MSACAnalytics setEnabled:true];
}
else
{
    // disabling appcenter's analytics module
    [MSACAnalytics setEnabled:false];
}