SDK 초기화¶

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { FTSDK, FTSDKConfig, EnvType, SDKLogLevel, SyncPageSize} from '@guancecloud/ft_sdk/Index';

const DOMAIN = 0x0000;

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    this.initFTSDK();
  }

  private initFTSDK(): void {
    try {
      // 로컬 환경 배포 (DataKit)
      // const sdkConfig = FTSDKConfig.builder(datakitUrl);

      // 공용망 DataWay
      const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
        .setDebug(true)
        .setSdkLogLevel(SDKLogLevel.D)
        .setServiceName('Your-App-Name')
        .setEnv(EnvType.PROD) // 또는 문자열 사용: .setEnv('prod')
        .setAutoSync(true)
        .setSyncPageSize(SyncPageSize.MEDIUM)
        .setDataSyncRetryCount(5)
        .setSyncSleepTime(0)
        .setCompressIntakeRequests(true);
        // DB 캐시 크기 제한을 활성화하려면 .enableLimitWithDbSize()를 호출합니다. dbSize를 전달하지 않으면 기본값 100MB입니다.

      FTSDK.install(sdkConfig, this.context);
      hilog.info(DOMAIN, 'FTSDK', 'FT SDK initialized successfully');
    } catch (error) {
      const errorObj: object = error as object;
      hilog.error(DOMAIN, 'FTSDK', `Failed to initialize FT SDK: ${JSON.stringify(errorObj)}`);
    }
  }
}

import {
  FTSDK,
  FTSDKConfig,
  FTProxyConfig,
  FTProxyAuthenticator,
  FTDnsConfig
} from '@guancecloud/ft_sdk/Index';

const proxyConfig: FTProxyConfig = {
  host: 'proxy.example.com',
  port: 8080,
  exclusionList: ['localhost', '127.0.0.1']
};

const proxyAuthenticator: FTProxyAuthenticator = {
  username: 'proxy-user',
  password: 'proxy-password'
};

const dnsConfig: FTDnsConfig = {
  servers: ['1.1.1.1', '8.8.8.8'],
  overHttpsUrl: 'https://dns.example.com/dns-query'
};

const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
  .setProxy(proxyConfig)
  .setProxyAuthenticator(proxyAuthenticator)
  .setDns(dnsConfig);

FTSDK.install(sdkConfig, this.context);

import {
  FTSDK,
  FTSDKConfig,
  FTDataFilters
} from '@guancecloud/ft_sdk/Index';

const dataFilters: FTDataFilters = new Map<string, Array<string>>();
dataFilters.set('logging', [
  "{ source in ['df_rum_harmonyos_log'] and message match ['.*password.*'] }"
]);
dataFilters.set('rum', [
  "{ source in [resource] and resource_status in ['404', '503'] }"
]);

const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
  .setEnableDataFilter(true)
  .setDataFilters(dataFilters);

FTSDK.install(sdkConfig, this.context);

// 로컬 및 원격 블랙리스트 필터링을 비활성화하지만, 설정된 로컬 규칙은 유지합니다.
sdkConfig.setEnableDataFilter(false);

// 설정된 로컬 규칙을 지웁니다. 서버 측 원격 규칙에는 영향을 미치지 않습니다.
sdkConfig.setDataFilters(null);

/**
 * 사용자 정보 바인딩 (사용자 ID만)
 * @param id 사용자 ID
 */
static bindRumUserDataById(id: string): void

/**
 * 사용자 정보 바인딩 (전체 사용자 데이터)
 * @param userData 사용자 데이터 객체
 */
static bindRumUserData(userData: UserData): void

/**
 * 사용자 정보 해제
 */
static unbindRumUserData(): void

import { FTSDK, UserData } from '@guancecloud/ft_sdk/Index';

// 방법 1: 사용자 ID만 바인딩 (빠른 바인딩에 권장)
FTSDK.bindRumUserDataById('user_001');

const userData = new UserData();
userData.setId('user_001');
userData.setName('test.user');
userData.setEmail('test@mail.com');
userData.setExts({
  'user_type': 'vip'
});
FTSDK.bindRumUserData(userData);

FTSDK.unbindRumUserData();

import { FTSDK } from '@guancecloud/ft_sdk/Index';

// 자동 동기화 비활성화
FTSDK.setAutoSync(false);

// 자동 동기화 활성화
FTSDK.setAutoSync(true);

import { FTSDK } from '@guancecloud/ft_sdk/Index';

FTSDK.flushSyncData();

import { FTSDK } from '@guancecloud/ft_sdk/Index';

await FTSDK.clearAllData();