Aracılığıyla paylaş

App Center Web Kancaları

  • Makale

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

Genel Bakış

Web kancaları, belirtilen bir olay gerçekleştiğinde üçüncü taraf uygulamaları bilgilendirmenin basit bir yoludur. Web kancalarının temel amacı, kullanıcıların portala gelmesini sağlamak yerine App Center'dan kullanıcılara önemli bilgileri iletmek veya belirli olaylar gerçekleştiğinde bildirim almak için API çağrıları çalıştırmaktır.

App Center'ın web kancaları, kullanıcıların aşağıdaki olaylar için bağlı uygulamalara otomatik bildirimler göndermesine olanak tanır:

  • Derleme:

    • Derleme başarısı:

      • Her zaman: uygulamanız başarıyla derlendiğinde
      • Yalnızca daha önce başarısız olduysa: uygulamanız bir veya daha fazla başarısız derlemeden sonra başarıyla derlendiğinde
      • Hiçbir zaman: Derlemenin başarılı olması için bildirim almazsınız

    • Derleme hatası:

      • Her zaman: uygulamanız derlenemiyorsa
      • Yalnızca daha önce başarılıysa: Uygulamanız bir veya daha fazla başarılı derlemeden sonra derlenemiyorsa
      • Hiçbir zaman: Derleme hatası için bildirim almazsınız

  • Kilitlenmeler: kilitlenme grubu oluşturulduğunda

  • Dağıt: Dağıtım grubuna yeni bir sürüm yayımlandığında

    Not

    Dağıt için, dağıtım grubuna yeni bir sürüm yayımlandığında web kancası tetiklenir. Yeni bir sürüm oluşturma gözden geçirme adımında test edenleri bilgilendirme seçeneğini işaretlediyseniz web kancası tetiklenmez. Tanılama için, web kancası sembollerin sağlandığı yeni hata grupları için tetiklenir. Yeni hata grubu için simge bulunmazsa web kancası tetiklenmez.

App Center, web kancasının belirtilen URL'sine bir HTTP POST yükü gönderir. Web kancaları, belirtilen uygulamanızın Ayarlar sayfasının altında uygulama düzeyinde yapılandırılır. Kullanıcıların web kancalarını oluşturmak ve yapılandırmak için uygulamada yönetici veya geliştirici izinlerine sahip olması gerekir. Şu anda yalnızca Slack ve Microsoft Teams için web kancalarını destekliyoruz. Diğer platformlara gönderi göndermek için, platformun gereksinimlerine uyma şeklimizi POST çeviren bir Azure işlevi yazabilirsiniz.

Başlarken

  1. App Center'a gidin ve web kancaları tümleştirmesi için istediğiniz uygulamayı seçin.

  2. Uygulamanızda, en sol taraftaki panelde Ayarlar'ı seçin

  3. Web Kancaları başlıklı satır panelinde sağ köşeye gidin ve Web Kancaları panelini açan kalem simgesine tıklayın.

    Web kancasının ayarlarını düzenleme

  4. Sağ üst köşede mavi Yeni Web Kancası düğmesine tıklayın ve şunu girin:

    • Web kancası adı

    • Web kancası URL'si

      Web kancası URL'sini tümleşik uygulamanızın ayarlarından alabilirsiniz (örneğin, Microsoft Teams'den web kancası URL'sini alma ve Slack'ten web kancası URL'sini alma hakkındaki ayrıntılar burada verilmiştir).

      Web kancası uyarılarını tetikleyecek olaylara karar vermek için Derleme durumu bildirimleri açılan listesini ve Kilitlenmeler ve Bildirimleri dağıt onay kutusunu seçin.

      Yeni web kancası oluşturma

  5. Bitti! Web kancanız artık oluşturulur ve etkinleştirilir. 4. adımı yineleyerek birden çok web kancası oluşturabilirsiniz.

  6. Web kancasını test etmek, devre dışı bırakmak veya silmek için web kancasının sağ üst köşesine geçin.

    • test , bağlı uygulamanıza bir test uyarısı gönderir.
    • devre dışı bırak ayarı web kancasını devre dışı bırakır ancak panonuzda bulunur.
    • sil seçeneği web kancasını panonuzdan kaldırır.

Bu olaylar gerçekleştiğinde App Center bildirimleri tümleşik uygulamalarınıza gönderilir. Örneğin, bağlı bir Slack uygulamasında Derleme başarılı bildirimi şöyle görünür:

Slack'te derleme başarılı bildirimi

Örnek web kancası yükü

JSON web kancası yükü örnekleri şunlardır:

  1. Oluşturma
{
  "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. Kilitlenme
{
  "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":"48573473-f069-4715-8bab-9ae42cec48b2"
}
  1. Dağıt
{
  "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":"f37c6194-9ac9-4504-be61-55re334r5649"
}

Ayrıca RequestBin kullanarak yükü de inceleyebilirsiniz. Bunu yapmak için RequestBin'e gidin, RequestBin Oluştur'a tıklayın ve ardından Depo Gözü URL'si altında oluşturulan URL'yi kopyalayın ve URL'yi App Center'da web kancası olarak yapıştırın.

Özel web kancası desteği

Diğer platformlara gönderi göndermek için platformun gereksinimlerini karşılama şeklimizi POST çeviren bir Azure işlevi yazabilirsiniz. Bunu yapmak için bir Azure işlevi oluşturun, URL'yi 4. adımda Web Kancası URL'si alanının altına yapıştırın; App Center web kancası yükünü bu uç noktaya postalar. Ardından yükü platformun gereksinimlerine göre değiştirebilirsiniz.