영어로 읽기

다음을 통해 공유


App Center 웹후크

중요

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

지원 타임라인 및 대안에 대해 자세히 알아봅니다.

개요

웹후크는 지정된 이벤트가 발생했을 때 타사 애플리케이션에 알리는 간단한 방법입니다. 웹후크의 기본 목표는 사용자가 포털에 오도록 하는 대신 App Center에서 사용자에게 중요한 정보를 전달하거나 특정 이벤트가 발생할 때 알림을 받기 위해 API 호출을 실행하는 것입니다.

App Center의 웹후크를 사용하면 사용자가 다음 이벤트에 대해 연결된 애플리케이션에 자동 알림을 보낼 수 있습니다.

  • 빌드:

    • 빌드 성공:

      • 항상: 앱이 성공적으로 빌드되는 경우
      • 이전에 실패한 경우에만: 하나 이상의 빌드 실패 후 앱이 성공적으로 빌드된 경우
      • 안 됨: 빌드 성공에 대한 알림을 받지 않습니다.
    • 빌드 실패:

      • 항상: 앱 빌드에 실패하는 경우
      • 이전에 성공한 경우에만: 하나 이상의 성공적인 빌드 후에 앱을 빌드하지 못한 경우
      • 안 됨: 빌드 실패에 대한 알림을 받지 않습니다.
  • 크래시: 크래시 그룹을 만들 때

  • 배포: 새 버전이 배포 그룹에 릴리스되는 경우

    참고

    배포의 경우 새 버전이 배포 그룹에 릴리스될 때 웹후크가 트리거됩니다. 새 릴리스를 만드는 검토 단계에서 테스터에게 알리지 않음을 선택하면 웹후크가 실행되지 않습니다. 진단의 경우 기호가 제공된 새 오류 그룹에 대해 웹후크가 트리거됩니다. 새 오류 그룹에 대한 기호가 없으면 웹후크가 실행되지 않습니다.

App Center는 웹후크의 지정된 URL에 HTTP POST 페이로드를 보냅니다. 웹후크는 지정된 앱의 설정 페이지 아래에 있는 앱 수준에서 구성됩니다. 웹후크를 만들고 구성하려면 앱에 관리자 또는 개발자 권한이 있어야 합니다. 현재 SlackMicrosoft Teams에 대한 웹후크만 지원합니다. 다른 플랫폼에 게시하려면 플랫폼의 요구 사항에 맞는 방식을 POST 변환하는 Azure 함수를 작성할 수 있습니다.

시작하기

  1. App Center로 이동하여 웹후크 통합에 사용할 특정 앱을 선택합니다.

  2. 앱의 맨 왼쪽 패널에서 설정을 선택합니다.

  3. 웹후크라는 행 패널에서 오른쪽 모서리로 이동하여 웹후크 패널을 표시하는 연필 아이콘을 클릭합니다.

    웹후크의 설정을 편집하는 방법

  4. 오른쪽 위 모서리에서 파란색 새 웹후크 단추를 클릭하고 다음을 입력합니다.

  5. 완료되었습니다. 이제 웹후크가 만들어지고 사용하도록 설정됩니다. 4단계를 반복하여 여러 웹후크를 만들 수 있습니다.

  6. 웹후크를 테스트, 사용 안 함 또는 삭제 하려면 웹후크의 극단적인 오른손으로 전환합니다.

    • 테스트 는 연결된 애플리케이션에 테스트 경고를 보냅니다.
    • 사용하지 않도록 설정하면 웹후크가 비활성 상태로 유지되지만 dashboard 있습니다.
    • 삭제하면 dashboard 웹후크가 제거됩니다.

이러한 이벤트가 발생하면 App Center 알림이 통합 애플리케이션에 게시됩니다. 예를 들어 연결된 Slack 애플리케이션에서 빌드 성공 알림의 모양은 다음과 같습니다.

Slack에서 성공 알림 빌드

예제 웹후크 페이로드

다음은 JSON 웹후크 페이로드의 예입니다.

  1. 빌드
{
  "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"
}
  1. 작동 중단
{
  "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"
}
  1. 배포
{
  "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는 해당 엔드포인트에 웹후크 페이로드를 게시합니다. 그런 다음 페이로드를 플랫폼의 요구 사항으로 수정할 수 있습니다.