중요합니다
Visual Studio App Center는 2026년 6월 30일까지 계속 지원되는 분석 및 진단 기능을 제외하고 2025년 3월 31일에 사용 중지되었습니다. 자세히 알아보기.
App Center SDK는 모든 또는 모든 서비스를 사용할 수 있도록 모듈식 아키텍처를 사용합니다.
App Center 분석 및 App Center 크래시를 사용하도록 앱에서 App Center SDK를 설정하는 방법을 시작해 보겠습니다.
1. 사전 요구 사항
시작하기 전에 다음 필수 조건을 충족시키는지 확인합니다.
UWP 프로젝트의 경우:
- 프로젝트가 Visual Studio 2017 업데이트 15.9 이상에서 설정됩니다.
- Windows 10 빌드 16299 이상을 실행하는 디바이스를 대상으로 합니다.
- 프로젝트는 유니버설 Windows 플랫폼 6.2.8 이상을 참조합니다(이 패키지는 일반적으로 암시적으로 참조됨).
- NuGet 4.3 이상.
WinUI 프로젝트의 경우:
- 프로젝트가 Visual Studio 2019 업데이트 16.9 이상에서 설정됩니다.
- Windows 10 빌드 17763 이상을 실행하는 디바이스를 대상으로 합니다.
- 프로젝트에서 WinUI 3 0.8.0 이상을 참조합니다.
비고
UWP용 Xamarin.Forms를 사용하려면 이 설명서 대신 Xamarin 시작 설명서를 따르세요.
2. App Center 포털에서 앱을 만들어 앱 비밀을 가져옵니다.
App Center 포털에서 앱을 이미 만든 경우 이 단계를 건너뛸 수 있습니다.
- 등록하거나 로그인하고 포털의 오른쪽 위 모서리에 있는 파란색 단추를 누릅니다. 즉 , 새로 추가 를 선택하고 드롭다운 메뉴에서 새 앱 추가 를 선택합니다.
- 앱의 이름 및 선택적 설명을 입력합니다.
- 위에서 설명한 대로 프로젝트에 따라 적절한 OS 및 플랫폼을 선택합니다.
- 새 앱 추가라는 오른쪽 아래 단추를 누릅니다.
앱을 만든 후에는 App Center 포털의 설정 페이지에서 앱 비밀을 가져올 수 있습니다.
설정 페이지의 오른쪽 위 모서리에서 세로 점 세 개를 클릭한 후 Copy app secret을/를 선택하여 앱 비밀을 가져옵니다.
3. App Center SDK 모듈 추가
App Center SDK는 Visual Studio 또는 패키지 관리자 콘솔을 사용하여 통합할 수 있습니다.
비주얼 스튜디오
- Visual Studio를 엽니다.
- 파일>열기를 클릭하고 솔루션을 선택합니다.
- 솔루션 탐색기에서 참조를 마우스 오른쪽 단추 로 클릭하고 NuGet 패키지 관리를 선택합니다.
- 찾아보기 탭에서 App Center를 검색하고 Microsoft.AppCenter.Analytics 및 Microsoft.AppCenter.Crashes 패키지를 설치합니다.
패키지 관리자 콘솔
- Visual Studio에서 콘솔을 엽니다. 이렇게 하려면 도구>NuGet 패키지 관리자 패키지 관리자>콘솔을 선택합니다.
- 다음 명령을 입력합니다.
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes
이제 애플리케이션에 SDK를 통합했으므로 이제 SDK를 시작하고 App Center 서비스를 사용해야 합니다.
비고
이식 가능한 프로젝트(예: Xamarin.Forms)에서 App Center SDK를 사용하는 경우 각 프로젝트에 이식 가능한 패키지, Android 및 iOS 패키지를 설치해야 합니다. 이렇게 하려면 각 하위 프로젝트를 열고 Visual Studio 섹션에 설명된 해당 단계를 따라야 합니다.
4. 기능 추가 Internet (Client)
Visual Studio 솔루션 탐색기에서 애플리케이션에 대한 Package.appxmanifest 파일을 두 번 클릭합니다. 기능 탭을 클릭한 다음 인터넷(클라이언트) 기능을 확인합니다.
5. SDK 시작
App Center를 사용하려면 사용하려는 모듈을 옵트인해야 합니다. 기본적으로 모듈은 시작되지 않으며 SDK를 시작할 때 각 모듈을 명시적으로 호출해야 합니다.
5.1 using 지시문 추가
API를 사용하기 전에 적절한 네임스페이스를 추가합니다.
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
5.2 메서드 추가 Start()
애플리케이션의 생성자에 다음 호출을 추가합니다.
AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
경고
소스 코드에 앱 비밀을 포함하지 않는 것이 좋습니다.
App Center 서비스를 별도로 시작해야 하는 경우 다음을 수행해야 합니다.
- 애플리케이션 비밀 키로 구성하거나 시작합니다.
- 코드를 여러 번 호출할 수 있는 경우 App Center가 이미 구성되어 있는지 확인합니다.
- 앱 비밀 없이 필요한 서비스를 시작합니다.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
AppCenter.Start(typeof(Analytics));
AppCenter.Start(typeof(Crashes));
}
5.3 자리 표시자를 앱 비밀로 바꾸기
애플리케이션에 맞는 실제 값으로 {Your App Secret} 텍스트를 바꾸어야 합니다. 앱 비밀은 App Center 포털의 시작 페이지 또는 설정 페이지에서 찾을 수 있습니다.
시작 페이지에는 앱 비밀이 포함된 위의 코드 샘플이 포함되어 있으며 전체 샘플을 복사하여 붙여넣을 수 있습니다.
위의 예제는 Start() 메서드 사용법을 보여주며 App Center Analytics를 포함합니다.
시작 메서드에서 각 서비스를 매개 변수로 명시적으로 지정하지 않는 한 해당 App Center 서비스를 사용할 수 없습니다. 또한 API는 Start() 앱의 수명 주기에서 한 번만 사용할 수 있습니다. 다른 모든 호출은 콘솔에 경고를 기록하고 첫 번째 호출에 포함된 서비스만 사용할 수 있습니다.
좋습니다, SDK가 자동으로 수집한 데이터를 포털에서 분석하기 위한 설정이 완료되었습니다.
App Center Analytics 및 App Center 크래시에 대한 설명서를 참조하여 두 서비스의 고급 기능을 사용자 지정하고 사용하는 방법을 알아봅니다.