기타 React Native API

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아보세요.

• Android
• iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• tvOS
• Cordova

로그 수준 조정

App Center에서 표시되는 로그 메시지의 양을 제어할 수 있습니다. 로그 메시지는 iOS의 콘솔에 표시되고 Android의 LogCat은 표시됩니다. API를 setLogLevel 사용하여 디버깅하는 동안 추가 로깅을 사용하도록 설정합니다. 기본 수준은 LogLevel.ASSERT iOS App Store 환경 및 Android 릴리스 빌드에 대한 것입니다. 그렇지 않으면 로 설정됩니다 LogLevel.WARNING.

모든 로그 메시지를 출력하려면 를 사용합니다 LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

참고

JavaScript가 로드되기 전에 JavaScript setLogLevel API는 앱 시작 코드에 대한 로깅을 늘릴 수 없습니다.

앱 시작에 대한 로깅을 늘리려면 네이티브 App Center setLogLevel API를 사용합니다.

iOS에서 프로젝트의 AppDelegate.m에서 (또는 AppCenterReactNativeAnalytics 또는 AppCenterReactNativeCrashesAppCenterReactNativePush)를 호출하기 [AppCenterReactNative register]; 전에 를 호출 [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; 합니다. 해당 파일에 누락된 경우 를 추가 @import AppCenter; 해야 합니다.

Android에서 의 콜백에서 onCreate 전에 SoLoader.init 를 호출 AppCenter.setLogLevel(android.util.Log.VERBOSE); 합니다MainApplication.java.

설치 식별

App Center SDK는 앱이 설치되면 각 디바이스에 대한 UUID를 만듭니다. 이 식별자는 앱이 업데이트되고 앱이 다시 설치되거나 사용자가 Android에서 모든 앱 데이터를 수동으로 삭제하는 경우에만 새 식별자가 생성될 때 디바이스에 대해 동일하게 유지됩니다. 다음 API는 디버깅 목적으로 유용합니다.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

사용자 식별

App Center SDK는 크래시 보고서를 보강하는 데 사용되는 사용자 ID 설정을 지원합니다. 이 기능을 사용하려면 다음을 수행합니다.

1. App Center SDK 시작 가이드에 설명된 대로 App Center SDK를 구성합니다.
2. userID 다음 코드를 사용하여 SDK에서 를 설정합니다.

AppCenter.setUserId("your-user-id");

사용자 ID를 설정한 후 App Center의 검색 기능을 사용하여 ID에 대한 특정 크래시 보고서를 검색할 수 있습니다. App Center의 검색 설명서에서 자세히 알아보세요.

참고

사용자 ID의 값은 256자로 제한됩니다. 충돌 보고서와 함께 표시되지만 영향을 받는 사용자의 집계 또는 수에는 사용되지 않습니다. 사용자 ID를 여러 번 설정하는 경우 마지막 사용자 ID만 사용됩니다. 이 값은 시작 사이에 SDK에 의해 저장되지 않으므로 각 애플리케이션을 시작하기 전에 사용자 ID를 직접 설정해야 합니다.

런타임에 모든 서비스 사용 안 함

모든 App Center 서비스를 한 번에 사용하지 않도록 설정하려면 API를 setEnabled() 사용합니다. 사용하지 않도록 설정하면 SDK는 App Center에 정보를 전달하지 않습니다.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

모든 서비스를 한 번에 사용하도록 설정하려면 동일한 API를 사용하지만 매개 변수로 전달 true 합니다.

await AppCenter.setEnabled(true);

상태는 애플리케이션이 시작되는 동안 디바이스의 스토리지에 유지됩니다.

네트워크 요청 허용 불허

App Center SDK에서 네트워크 요청은 기본적으로 허용됩니다. App Center SDK가 사용자 우려로 수집하는 데이터를 보내려면 자동 전송 데이터를 허용하지 않습니다.

await AppCenter.setNetworkRequestsAllowed(false);

이 경우 App Center SDK는 계속해서 데이터를 수집하지만 네트워크 요청이 허용되는 경우에만 전송됩니다.

await AppCenter.setNetworkRequestsAllowed(true);

참고

이 값은 시작 사이에 유지됩니다.

언제든지 App Center SDK에서 데이터를 보낼 수 있는지 여부를 검사 수 있습니다.

await AppCenter.isNetworkRequestsAllowed();

참고

SharedPreferences에 저장된 값은 Android 플랫폼에서 시작될 때까지 AppCenter 무시됩니다. AppCenter가 시작되기 전에 값이 변경되지 않은 경우 또는 true 를 사용하여 setNetworkRequestsAllowed 설정된 마지막 값을 반환합니다.

런타임에서 서비스 상태 변경

다음 코드를 사용하여 런타임에 서비스를 사용하거나 사용하지 않도록 설정할 수 있습니다.

await AppCenter.Analytics.setEnabled(false);

App Center가 사용하도록 설정되어 있는지 확인

App Center를 사용할지 여부를 검사 수도 있습니다.

const enabled = await AppCenter.isEnabled();

런타임 시 App Center SDK 버전 확인

현재 사용 중인 App Center SDK 버전을 가져올 수 있습니다.

AppCenter.getSdkVersion();