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')
        .addGlobalContext('app_channel', new String('appgallery'))
        .setAutoSync(true)
        .setSyncPageSize(SyncPageSize.MEDIUM)
        .setDataSyncRetryCount(5)
        .setSyncSleepTime(0)
        .setCompressIntakeRequests(true);

      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)}`);
    }
  }
}

const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
  .enableFileDataStore();

const shadowConfig = FTSDKConfig.builder(datawayUrl, clientToken)
  .setFileDataStoreShadow(true);

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

const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
  // 総キャッシュサイズ制限を有効にします。例では 100MB。
  .enableLimitWithCacheSize(100 * 1024 * 1024)
  // キャッシュが上限に達した場合、最も古いキャッシュデータを削除します。
  .setCacheDiscard(CacheDiscard.DISCARD_OLDEST);

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();