App Center 웹후크
중요
Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.
웹후크는 지정된 이벤트가 발생했을 때 타사 애플리케이션에 알리는 간단한 방법입니다. 웹후크의 기본 목표는 사용자가 포털에 오도록 하는 대신 App Center에서 사용자에게 중요한 정보를 전달하거나 특정 이벤트가 발생할 때 알림을 받기 위해 API 호출을 실행하는 것입니다.
App Center의 웹후크를 사용하면 사용자가 다음 이벤트에 대해 연결된 애플리케이션에 자동 알림을 보낼 수 있습니다.
빌드:
빌드 성공:
- 항상: 앱이 성공적으로 빌드되는 경우
- 이전에 실패한 경우에만: 하나 이상의 빌드 실패 후 앱이 성공적으로 빌드된 경우
- 안 됨: 빌드 성공에 대한 알림을 받지 않습니다.
빌드 실패:
- 항상: 앱 빌드에 실패하는 경우
- 이전에 성공한 경우에만: 하나 이상의 성공적인 빌드 후에 앱을 빌드하지 못한 경우
- 안 됨: 빌드 실패에 대한 알림을 받지 않습니다.
크래시: 크래시 그룹을 만들 때
배포: 새 버전이 배포 그룹에 릴리스되는 경우
참고
배포의 경우 새 버전이 배포 그룹에 릴리스될 때 웹후크가 트리거됩니다. 새 릴리스를 만드는 검토 단계에서 테스터에게 알리지 않음을 선택하면 웹후크가 실행되지 않습니다. 진단의 경우 기호가 제공된 새 오류 그룹에 대해 웹후크가 트리거됩니다. 새 오류 그룹에 대한 기호가 없으면 웹후크가 실행되지 않습니다.
App Center는 웹후크의 지정된 URL에 HTTP POST 페이로드를 보냅니다. 웹후크는 지정된 앱의 설정 페이지 아래에 있는 앱 수준에서 구성됩니다. 웹후크를 만들고 구성하려면 앱에 관리자 또는 개발자 권한이 있어야 합니다. 현재 Slack 및 Microsoft Teams에 대한 웹후크만 지원합니다. 다른 플랫폼에 게시하려면 플랫폼의 요구 사항에 맞는 방식을 POST
변환하는 Azure 함수를 작성할 수 있습니다.
App Center로 이동하여 웹후크 통합에 사용할 특정 앱을 선택합니다.
앱의 맨 왼쪽 패널에서 설정을 선택합니다.
웹후크라는 행 패널에서 오른쪽 모서리로 이동하여 웹후크 패널을 표시하는 연필 아이콘을 클릭합니다.
오른쪽 위 모서리에서 파란색 새 웹후크 단추를 클릭하고 다음을 입력합니다.
웹후크 이름
Webhook URL
통합 애플리케이션의 설정에서 웹후크 URL을 가져올 수 있습니다(예: Microsoft Teams에서 웹후크 URL을 가져오는 방법 및 Slack에서 웹후크 URL을 가져오는 방법에 대한 자세한 내용은 다음과 같습니다).
빌드 상태 알림 드롭다운과 크래시 및 배포 알림 확인란을 선택하여 웹후크 경고를 트리거할 이벤트를 결정합니다.
완료되었습니다. 이제 웹후크가 만들어지고 사용하도록 설정됩니다. 4단계를 반복하여 여러 웹후크를 만들 수 있습니다.
웹후크를 테스트, 사용 안 함 또는 삭제 하려면 웹후크의 극단적인 오른손으로 전환합니다.
- 테스트 는 연결된 애플리케이션에 테스트 경고를 보냅니다.
- 사용하지 않도록 설정하면 웹후크가 비활성 상태로 유지되지만 dashboard 있습니다.
- 삭제하면 dashboard 웹후크가 제거됩니다.
이러한 이벤트가 발생하면 App Center 알림이 통합 애플리케이션에 게시됩니다. 예를 들어 연결된 Slack 애플리케이션에서 빌드 성공 알림의 모양은 다음과 같습니다.
다음은 JSON 웹후크 페이로드의 예입니다.
- 빌드
{
"app_name": "myFirstApp",
"branch": "main",
"build_status": "Succeeded",
"build_id": "33",
"build_link": "https://appcenter.ms/users/{user-id}/apps/{app-name}/build/branches/main/builds/33",
"build_reason": "manual",
"finish_time": "2018-06-14T23:59:05.2542221Z",
"icon_link": "https://appcenter-filemanagement-distrib4ede6f06e.azureedge.net/f7794e4c-42f1-4e7c-8013-07ed2e1b733d/ic_launcher.png?sv=2020-02-18&sr=c&sig=gs4JfcWjpKeYH%2F%2Fg0jEtSKKbeRkug9q%2FldslmzzeOg0%3D&se=2020-02-26T08%3A57%3A58Z&sp=r",
"notification_settings_link": "https://appcenter.ms/users/{user-id}/apps/{app-name}/settings/notifications",
"os": "iOS",
"start_time": "2018-06-14T23:57:03.4379381Z",
"source_version": "55820a357ba26831f2eeb3be9973a4ef20618b73",
"sent_at": "2018-06-14T23:59:08.4897604Z"
}
- 작동 중단
{
"id":"3698593379u",
"name":"android.app.Activity.performResume (Activity.java:5084)",
"reason":"android.app.SuperNotCalledException",
"url":"https://appcenter.ms/orgs/{org-id}/apps/{app-name}/crashes/errors/3698273379u",
"app_display_name":"{app-name}",
"app_platform":"Java",
"app_version":"2.0.1(42)",
"stack_trace":[],
"affected_users":0,
"crash_count":0,
"sent_at":"2019-05-16T23:47:31.4881512Z",
"app_id":"00001111-aaaa-2222-bbbb-3333cccc4444"
}
- 배포
{
"app_name":"{app-name}",
"app_display_name":"{app-display-name}",
"release_id":"123",
"platform":"Android",
"uploaded_at":"2018-07-17T20:46:14Z",
"fingerprint":"0abed1269e4ae3bf524e4cc7165f4f34",
"release_notes":"",
"version":"74",
"short_version":"1.7.0",
"min_os":"4.0.3",
"mandatory_update":true,
"size":2634279,
"provisioning_profile_name":null,
"provisioning_profile_type":null,
"bundle_identifier":"com.microsoft.appcenter.test",
"install_link":"https://install.appcenter.ms/orgs/{org-name}/apps/{app-name}/releases/123?source=email",
"icon_link":"https://appcenter-filemanagement-distrib4ede6f06e.azureedge.net/f7794e4c-42f1-4e7c-8013-07ed2e1b733d/ic_launcher.png?sv=2020-02-18&sr=c&sig=gs4JfcWjpKeYH%2F%2Fg0jEtSKKbeRkug9q%2FldslmzzeOg0%3D&se=2020-02-26T08%3A57%3A58Z&sp=r",
"distribution_group_id":"1a5a0605-4b9c-4de2-9a35-t569456df0cc",
"installable":true,
"sent_at":"2019-05-16T23:20:08.7799314Z",
"app_id":"11112222-bbbb-3333-cccc-4444dddd5555"
}
RequestBin을 사용하여 페이로드를 검사할 수도 있습니다. 이렇게 하려면 RequestBin으로 이동하여 RequestBin 만들기를 클릭한 다음 , 생성된 URL을 Bin URL 아래에 복사하여 App Center에서 URL을 웹후크로 붙여넣습니다.
다른 플랫폼에 게시하려면 플랫폼의 요구 사항에 맞는 방식을 POST
변환하는 Azure 함수를 작성할 수 있습니다. 이렇게 하려면 Azure 함수를 만들고, 4단계의 웹후크 URL 필드 아래에 URL을 붙여넣고, App Center는 해당 엔드포인트에 웹후크 페이로드를 게시합니다. 그런 다음 페이로드를 플랫폼의 요구 사항으로 수정할 수 있습니다.