Birleştirilmiş Güncelleme Kontrolleri

Birleştirilmiş Güncelleme Kontrolleri (UUC), BT yöneticilerine şirkete ait Android cihazlarda yazılım güncellemelerinin ne zaman indirilip uygulanacağını kontrol etmeleri için tek ve tutarlı bir yöntem sunar. Böylece güncellemeler, işletme faaliyetlerini kesintiye uğratmaz.

Tek bir UUC politikasıyla aşağıdaki yazılım bileşenlerinin güncellemelerini kontrol edebilirsiniz:

• Büyük işletim sistemi güncellemeleri ile küçük işletim sistemi ve güvenlik güncellemeleri de dahil olmak üzere cihaz üreticisi (OEM) tarafından yayınlanan işletim sistemi güncellemeleri.
• Google Play sistem güncellemeleri (Mainline).
• Google Play Hizmetleri ve Android System WebView gibi Google sistem hizmetleri (grup halinde veya tek tek)

UUC kurallarını bir Policy kaynağının unifiedUpdatePolicy alanında tanımlarsınız. Android Device Policy (ADP) uygulaması, UUC için cihaz üzerindeki merkezi karar noktasıdır.

Ön koşullar

UUC'yi yapılandırmadan önce aşağıdaki koşulları karşıladığınızdan emin olun:

• EMM çözümünüz bir kuruluş için politikalar oluşturabilir ve güncelleyebilir.
• Cihazlar şirkete aittir ve tümüyle yönetilen cihaz olarak veya şirkete ait bir cihazda iş profili ile yapılandırılmıştır. UUC, kişisel cihazlarda desteklenmez.
• Cihazlar, kontrol etmek istediğiniz her güncelleme hedefi için desteklenen minimum Android sürümünü karşılamalıdır. Bu sürümler aşağıdaki tabloda gösterilmiştir:

Dikkat edilmesi gereken noktalar ve sınırlamalar

UUC entegrasyonunuzu planlamadan önce aşağıdaki noktaları ve sınırlamaları inceleyin:

• İlk kurulum sihirbazı: Cihaz ilk kurulum sihirbazındayken UUC politikaları uygulanmaz. Cihaz kurulumu sırasında Google Play'den veya OEM OTA aracısından kritik güncellemeler alınabilir.
• Kurulumdan sonraki erken güncellemeler: UUC politikaları, politika ADP'ye ulaşmadan önce cihaz kurulumundan hemen sonra başlayan otomatik güncellemelere (ör. Google Play Hizmetleri'nin erken güncellemeleri) uygulanmayabilir.
• Paket halinde OTA modülleri: OEM OTA güncellemeleri, Mainline modüllerinin ve Google sistem hizmetlerinin güncellenmiş sürümlerini içerebilir. OEM OTA güncellemesi yüklendiğinde bu paket bileşenler otomatik olarak güncellenir.
• Google Play sistem güncellemeleri (Mainline): UUC, Mainline güncellemesini tek bir birim olarak kontrol eder. Bu nedenle, bağımsız Mainline paketleri ayrı ayrı kontrol edilemez. UUC yalnızca indirme aşamasının başlangıcını yönetir: Mainline indirme işlemi başladıktan sonra durdurulamaz. İndirme işlemi başladıktan sonra bir BLOCK kuralı uygulanırsa güncelleme, cihazın bir sonraki yeniden başlatılmasında tamamlanır.
• Engelleme dönemlerinde manuel güncellemeler: Google Play sistem güncellemeleri (Mainline) ve Google sistem hizmetleri için BLOCK kuralı yalnızca otomatik güncellemeleri engeller. Kullanıcılar, bir BLOCK kuralı etkin olsa bile bu bileşenleri manuel olarak güncelleyebilir. Bu sorun daha sonraki bir sürümde giderilecektir.
• Muaf tutulan uygulamalar: UUC, Google Play Store uygulaması veya ADP uygulaması için güncellemeleri yönetmez.

UUC politikalarını anlama

UnifiedUpdatePolicy, sıralı bir Rule nesneleri listesinden oluşur. Her kural şunları belirtir:

• EMM çözümünüz tarafından tanımlanan bir tanımlayıcı (id)
• bir veya daha fazla yazılım güncelleme hedefi
• isteğe bağlı değerlendirme aşamaları
• Zamana dayalı koşullar içeren bir veya daha fazla isteğe bağlı yüklem
• Güncellemenin nasıl işleneceğini belirleyen bir sonuç

Kural değerlendirmesi

ADP, bekleyen bir güncellemeyi değerlendirirken güncellemenin hedefi ve aşaması için geçerli olan tüm kuralları rules içinde göründükleri sırayla dikkate alır. ADP, yüklemi true olarak değerlendirilen ilk kuralı seçer ve zincirleme bir if-else ifadesi gibi sonucunu uygular. Hiçbir kuralın yüklemi true olarak değerlendirilmezse bileşenden sorumlu güncelleme istemcisi, güncellemeyi normal şekilde yönetir.

Kural tanımlayıcıları

Her kural için EMM çözümünüz tarafından tanımlanan en fazla 64 karakterlik bir id gerekir. id boş olmamalı ve bir politikanın kuralları arasında benzersiz olmalıdır.

Hedefleri güncelleme

Her kural, yinelenen öğeler içermeyen ve boş olmayan bir targets listesi belirtmelidir. Tek bir kuralda birden fazla hedef belirtmek, her biri tek bir hedefe sahip birden fazla kuralı aynı sırayla tanımlamakla eşdeğerdir.

Aşağıdaki tabloda, desteklenen targetType değerleri açıklanmaktadır:

Değerlendirme aşamaları

OS_UPDATE_WITH_API_LEVEL_CHANGE ve OS_UPDATE_WITHOUT_API_LEVEL_CHANGE hedefleri için isteğe bağlı olarak bir kuralın değerlendirileceği stages değerini belirtebilirsiniz:

• STAGE_DOWNLOAD: Kural, güncelleme indirilmeden önce değerlendirilir.
• STAGE_APPLY: Kural, güncellemeyi uygulayan bir işlem (ör. otomatik yeniden başlatmayı tetikleme) yapılmadan önce değerlendirilir.

stages boşsa kural tüm aşamalarda değerlendirilir. Not: GOOGLE_SYSTEM_SERVICES, SINGLE_APP ve GOOGLE_PLAY_SYSTEM_UPDATE hedefleri için aşamalar yoksayılır.

Yüklemler

predicate, bir kuralın eşleştiği zamana dayalı koşulları tanımlar. Örneğin, haftanın günleri, günün belirli bir saat aralığı (saat ayrıntı düzeyinde), cihazın yerel saat dilimindeki bir takvim tarihi aralığı veya güncellemenin cihaz için ne kadar süredir kullanılabilir olduğu (24 saatin katları olarak).

Tek bir yüklemde ayarlanan tüm koşullar, mantıksal AND kullanılarak birleştirilir. Boş veya atlanmış bir yüklem her zaman true olarak değerlendirilir. Yüklem alanlarının ve kısıtlamalarının tam listesi için Predicate referans belgelerine bakın.

Günün saati aralıklarını (timeOfDayLowerBound ve timeOfDayUpperBound) yapılandırırken aşağıdaki değerlendirme kurallarını göz önünde bulundurun:

• Saat sınırları: Günün saati sınırları, cihazın yerel saat diliminde hh:00:00 olarak değerlendirilir. timeOfDayUpperBound, pencereyi belirtilen saatte kapatır (örneğin, 9 alt sınırı ve 17 üst sınırı, 09:00 ile 17:00 arasını kapsar).
• Geçerli sınır sıralaması: Her iki sınır da aynı kuralda ayarlandığında timeOfDayUpperBound, timeOfDayLowerBound değerinden kesinlikle daha büyük olmalıdır. timeOfDayUpperBound, timeOfDayLowerBound değerinden küçük veya bu değere eşitse ya da 0 (00:00) olarak ayarlanmışsa yüklem false olarak değerlendirilir.
• Gün sonu ve gece pencereleri: Bir pencereyi gün sonuna (24:00) kadar uzatmak için timeOfDayUpperBound değerini atlayın. Gece yarısını kapsayan bir gece aralığı (örneğin, 22:00 - 04:00) tanımlamak için aralığı iki sıralı kurala bölün: yalnızca timeOfDayLowerBound ayarlanmış bir akşam kuralı ({ "hours": 22 }) ve yalnızca timeOfDayUpperBound ayarlanmış bir sabah kuralı ({ "hours": 4 }, daysOfWeek ayarlanmışsa ertesi günü hedefleyen).

Sonuçlar

outcome, bir kuralın yüklemi true olarak değerlendirildiğinde ADP'nin güncelleme aracısına nasıl devam edeceğini belirtir. Aşağıdaki tabloda, desteklenen outcomeType değerleri açıklanmaktadır:

Maksimum erteleme sınırları

UUC, BLOCK veya USER_PROMPT sonucu veren güncellemelerin her güncelleme hedefi için maksimum erteleme süresine kadar ertelenmesine olanak tanır. Bir güncelleme, maksimum erteleme süresinden daha uzun bir süre boyunca kullanılabilir olduğunda tüm BLOCK veya USER_PROMPT sonuçları varsayılan olarak geçersiz kılınır ve güncelleme istemcisi güncellemeyi normal şekilde yönetir.

Aşağıdaki tabloda, hedef ve yönetim moduna göre maksimum erteleme sınırları listelenmiştir:

systemUpdate önceliği

unifiedUpdatePolicy özelliğini mevcut bir politikaya eklemeden önce ayarlarını inceleyin ve ihtiyacınız olan davranışı UUC kurallarıyla yeniden oluşturun.systemUpdate Örneğin, işletim sistemi güncellemelerini çalışma saatlerinin dışında tutmak için Çalışma saatleri içinde önemli işletim sistemi güncellemelerini engelleme bölümündeki gibi bir BLOCK kuralı kullanın.

Bu öncelik davranışı, AMAPI SDK'sını kullanan özel DPC'lerden farklıdır. Bu DPC'lerde, OEM OTA güncellemeleri için AOSP SystemUpdatePolicy, UUC'ye göre önceliklidir. Ayrıntılar için AOSP SystemUpdatePolicy önceliği başlıklı makaleyi inceleyin. Cihazda OEM'e özel bir güncelleme yönetim hizmeti (ör. kurumsal OTA çözümü) etkinse bu hizmet, OEM OS güncellemeleri (OS_UPDATE_WITH_API_LEVEL_CHANGE ve OS_UPDATE_WITHOUT_API_LEVEL_CHANGE) için UUC'ye göre önceliklidir.

UUC politikasını yapılandırma

Bir politika kaynağında unifiedUpdatePolicy alanını ayarlayabilir, alabilir ve temizleyebilirsiniz. Ayrıca, politikayı kullanan cihazların uygunluğunu kontrol edebilirsiniz.

UUC politikasını ayarlama

UUC'yi yapılandırmak için politikaya bir unifiedUpdatePolicy nesnesi ekleyin. UUC politikasını mevcut bir politikanın diğer ayarlarını değiştirmeden uygulamak için updateMask=unifiedUpdatePolicy ile enterprises.policies.patch yöntemini çağırın:

PATCH https://androidmanagement.googleapis.com/v1/enterprises/{enterpriseId}/policies/{policyId}?updateMask=unifiedUpdatePolicy

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Policy",
        "targets": [
          {
            "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE"
          }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}

Güncellenen politika, bu politikayı kullanan tüm cihazlara uygulanır. ADP, kontrol edilen bir bileşen için güncelleme olduğunda her cihazdaki kuralları değerlendirir.

UUC politikasını alma

Yapılandırılmış UUC kurallarını okumak için enterprises.policies.get yöntemini çağırın ve döndürülen politikanın unifiedUpdatePolicy alanını inceleyin:

GET https://androidmanagement.googleapis.com/v1/enterprises/{enterpriseId}/policies/{policyId}

UUC politikasını temizleme

Bir politikadan tüm UUC kurallarını kaldırmak için updateMask=unifiedUpdatePolicy ve unifiedUpdatePolicy içermeyen bir istek gövdesiyle enterprises.policies.patch yöntemini çağırın:

PATCH https://androidmanagement.googleapis.com/v1/enterprises/{enterpriseId}/policies/{policyId}?updateMask=unifiedUpdatePolicy

{}

Politika yapılandırma örnekleri

Aşağıdaki örneklerde, yaygın senaryolar için unifiedUpdatePolicy nesnesi gösterilmektedir. UUC politikasını ayarlama bölümünde açıklandığı şekilde enterprises.policies.patch ile uygulayın. Aynı senaryolar, AMAPI SDK ile Birleştirilmiş Güncelleme Denetimlerini Yapılandırma bölümünde Kotlin ve Java kodu olarak da mevcuttur.

Çalışma saatleri içinde önemli OS güncellemelerini engelleme

Aşağıdaki kural, pazartesiden cumaya 09:00-17:00 saatleri arasında önemli OS güncellemelerini (OS_UPDATE_WITH_API_LEVEL_CHANGE) engeller:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Policy",
        "targets": [
          {
            "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE"
          }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}

İşletim sistemi güncellemelerini güncelleme yaşına göre zorunlu kılma

Aşağıdaki kural, cihaz için 7 güne kadar (604800s) kullanılabilir olan önemli OS güncellemelerini zorunlu kılar:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Force Policy",
        "targets": [
          {
            "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE"
          }
        ],
        "predicate": {
          "updateAgeUpperBound": "604800s"
        },
        "outcome": {
          "outcomeType": "FORCE"
        }
      }
    ]
  }
}

Tek bir Google sistem hizmeti uygulaması için güncellemeleri engelleme

Android System WebView (com.google.android.webview) gibi Google sistem hizmetlerinin parçası olan belirli bir uygulamayı kontrol etmek için targetType değerini SINGLE_APP olarak ayarlayın ve uygulamanın packageName değerini singleApp içinde belirtin. Aşağıdaki kural, pazartesiden cumaya 09:00-17:00 saatleri arasında WebView güncellemelerini engeller:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Webview Policy",
        "targets": [
          {
            "targetType": "SINGLE_APP",
            "singleApp": {
              "packageName": "com.google.android.webview"
            }
          }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}

Tüm güncelleme hedeflerinde birden fazla kuralı birleştirme

Kurallar sırayla değerlendirildiğinden, belirli aralıklarda güncellemeleri engellemek ve bu aralıkların dışında güncellemeleri zorunlu kılmak için birden fazla kuralı birleştirebilirsiniz.

Aşağıdaki örnekte, dört kategori hedefinde (OS_UPDATE_WITH_API_LEVEL_CHANGE, OS_UPDATE_WITHOUT_API_LEVEL_CHANGE, GOOGLE_SYSTEM_SERVICES ve GOOGLE_PLAY_SYSTEM_UPDATE) iki sıralı kural uygulanmaktadır:

1. Çalışma saatleri içinde (pazartesi-cuma, 09:00-17:00) tüm güncellemeleri engelleme
2. Çalışma saatleri dışında, 7 güne kadar kullanılabilir olan güncellemeleri zorunlu kıl.

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Policy - rule1",
        "targets": [
          { "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE" },
          { "targetType": "OS_UPDATE_WITHOUT_API_LEVEL_CHANGE" },
          { "targetType": "GOOGLE_SYSTEM_SERVICES" },
          { "targetType": "GOOGLE_PLAY_SYSTEM_UPDATE" }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      },
      {
        "id": "Force Policy - rule2",
        "targets": [
          { "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE" },
          { "targetType": "OS_UPDATE_WITHOUT_API_LEVEL_CHANGE" },
          { "targetType": "GOOGLE_SYSTEM_SERVICES" },
          { "targetType": "GOOGLE_PLAY_SYSTEM_UPDATE" }
        ],
        "predicate": {
          "updateAgeUpperBound": "604800s"
        },
        "outcome": {
          "outcomeType": "FORCE"
        }
      }
    ]
  }
}

Güncellemeleri belirli bir takvim tarihine kadar kısıtlama

Cihazın yerel saat diliminde belirli bir takvim tarihi aralığındaki güncellemeleri kısıtlamak veya bunlara izin vermek için dateLowerBound ve dateUpperBound öğelerini kullanabilirsiniz. Aşağıdaki kural, dört kategori hedefi için güncellemeleri 14 Mart 2026'ya kadar engeller:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "block_until_date",
        "targets": [
          { "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE" },
          { "targetType": "OS_UPDATE_WITHOUT_API_LEVEL_CHANGE" },
          { "targetType": "GOOGLE_SYSTEM_SERVICES" },
          { "targetType": "GOOGLE_PLAY_SYSTEM_UPDATE" }
        ],
        "predicate": {
          "dateUpperBound": { "year": 2026, "month": 3, "day": 14 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}