IntuneIntune App SDK for Android - App ConfigurationUygulama Yapılandırması

Android için Microsoft Intune Uygulama SDK'sı, Intune uygulama koruma ilkelerini (MAM ilkeleri olarak da bilinir) yerel Java/Kotlin Android uygulamanıza dahil etmenize olanak tanır. Bir IntuneIntune-yönetilen uygulama, IntuneIntune App SDK ile tümleştirilmiş bir uygulamadır. IntuneIntune yöneticileri, IntuneIntune uygulamayı etkin olarak yönettiğinde, IntuneIntune-managed app to your IntuneIntune-managed app.

Not

Bu kılavuz birkaç ayrı aşamaya ayrılmıştır. 1. Aşama: Entegrasyonu Planlama bölümünü gözden geçirerek başlayın.

Aşama 6: App ConfigurationUygulama Yapılandırması

Aşama Hedefleri

  • Android'de uygulama yapılandırma seçenekleri hakkında bilgi edinin.
  • Varsa, uygulamanızın hangi yapılandırmaları eklemesi gerektiğine karar verin.
  • TIntuneIntune Uygulama SDK'sı uygulama yapılandırma API'lerini tümleştirin.
  • Özel uygulama yapılandırmalarınız için çakışma çözme mantığı uygulayın.

App ConfigurationUygulama Yapılandırması on Android

Yönetilen yapılandırmalar veya uygulama kısıtlamaları olarak da adlandırılan uygulama yapılandırmaları, yönetilen bir ortamda kullanıldığında yöneticilere uygulama deneyimi üzerinde ek denetim sağlamak için uygulamanıza ekleyebileceğiniz uygulamaya özgü ve geliştirici tanımlı ayarlardır. Örneğin, uygulamanız bir tarayıcıysa, yöneticilerin yer imlerini önceden ayarlamasına, belirli web sayfalarını engellemesine veya gizli modları devre dışı bırakmasına olanak tanıyan yapılandırmalar eklemeyi seçebilirsiniz. Uygulama yapılandırması, uygulamanızın yönetim deneyimini geliştirmek için tamamen isteğe bağlı ancak güçlü bir araçtır.

Daha fazla ayrıntı için TMicrosoft IntuneMicrosoft Intune için uygulama yapılandırma ilkeleri bölümüne bakın.

Android'in Built-In Uygulaması Yapılandırmaları

Android, yönetilen yapılandırmalar adı verilen platformda yerleşik uygulama yapılandırmasına sahiptir. Bu yapılandırmaların IntuneIntune Uygulama SDK'sına bağımlılığı yoktur ve IntuneIntune Uygulama SDK'sını tümleştirmeyen uygulamalarda etkinleştirilebilir. Bu yapılandırmalar yalnızca uygulamanız Google'ın Android Enterprise modlarından biriyle yönetilen bir cihazda kullanıldığında geçerlidir. Bu Android Enterprise modlarının Microsoft IntuneMicrosoft Intune'da nasıl ayarlanacağıyla ilgili ayrıntılar için Android cihazlarını kaydetme bölümüne bakın. Yöneticiler, Microsoft IntuneMicrosoft Intune'da yönetilen Android Kurumsal cihazlar için bu uygulama yapılandırma ilkelerini yapılandırabilir.

Uygulamanız, yönetici tarafından yapılandırılan bu değerleri Android'ler RestrictionsManager aracılığıyla veya IntuneIntune Uygulama SDK'sı aracılığıyla alabilir. Daha fazla bilgi için SDK'dan uygulama yapılandırmasını alma bölümüne bakın.

Yönetilen Google Play uygulamaları için yetkilendirilmiş kapsamlar

Uygulama geliştiricileri, Yönetilen Google Play uygulamaları için gelişmiş izinleri entegre etmek üzere yetkilendirilmiş kapsamları kullanabilir. Yetkilendirilmiş kapsamlar, Yönetilen Google Play uygulamaları için aşağıdaki özellikleri sağlar:

  • Diğer uygulamaların sertifika yüklemesine ve yönetmesine izin ver
  • Uygulamanın Android güvenlik günlüklerine erişmesine izin ver
  • Uygulamanın Android ağ etkinliği günlüklerine erişmesine izin ver

Bu özellikler Google'ın API'si kullanılarak bir Managed Google Play uygulamasına entegre edildikten sonra, bu ayarları Intune'de cihaz yapılandırma profillerini kullanarak yapılandırabilirsiniz. Daha fazla bilgi için bkz. Android Kurumsal cihaz ayarları -> Şirkete Ait > Uygulamalar.

Uygulama uygulama ayrıntıları için bkz. Android geliştirici belgeleri - Temsilci kapsamları.

IntuneIntune App SDK App Configurations

TIntuneIntune Uygulama SDK'sı, Android Enterprise tarafından yönetilen yapılandırmalardan ayrı olarak uygulama yapılandırmaları sunmak için başka bir mekanizmayı destekler. Bu yapılandırmalar Microsoft IntuneMicrosoft Intune'a özeldir ve yalnızca IntuneIntune Uygulama SDK'sını tümleştiren uygulamalar için geçerlidir. Ancak bu yapılandırmalar Android Enterprise yönetimine sahip cihazlarla sınırlı değildir. Yöneticiler, Microsoft IntuneMicrosoft Intune'da yönetilen uygulamalar için bu uygulama yapılandırma ilkelerini yapılandırabilir.

Not

Uygulama yapılandırması, Graph APIGraph API kullanılarak da yapılandırılabilir. Daha fazla bilgi için MAM Hedefli Yapılandırma için Graph API belgelerine bakın.

Uygulamanız, yönetici tarafından yapılandırılan bu değerleri IntuneIntune Uygulama SDK'sı aracılığıyla almalıdır. Daha fazla bilgi için SDK'dan uygulama yapılandırmasını alma bölümüne bakın.

Uygulamama hangi yapılandırmaları eklemeliyim?

Bu kılavuz sizin için bu soruyu cevaplayamaz. Yalnızca siz ve ekibiniz, yönetim altındayken uygulamanızı hangi özelliklerin daha değerli kıldığını bilebilirsiniz.

Aşağıdaki sorular, tartışmalara rehberlik etmeye ve uygulamanıza eklemek isteyebileceğiniz yapılandırmaları ortaya çıkarmaya yardımcı olabilir:

  • Uygulamanız bugün hangi özellikleri sunuyor?
    • Yönetim altındayken bu özelliklerden herhangi birini devre dışı bırakmanın bir değeri var mı?
    • Yönetim altındayken bu özelliklerden herhangi birini değiştirmenin bir değeri var mı?
  • Uygulamanız bugün yönetim altında nasıl kullanılıyor?
    • Yöneticilerin, kullanıcıları adına önceden yapılandırabileceği seçenekler var mı?
    • Yönetilen senaryolara özel olarak, yöneticilerin veya son kullanıcıların gerçekleştirdiği eylemler var mı?
    • Yönetilen kullanıcılarınız, tüm kullanıcı popülasyonunuz için uygun olmayabilecek özellikler talep etti mi?

Uygulamanıza eklemeye karar verdiğiniz her yapılandırma için üç öğe tanımlamanız gerekir:

  • Anahtar - bu dize, bu ayarı diğer ayarlardan benzersiz olarak tanımlar. Yöneticiler tarafından yapılandırılacağı için insanlar tarafından okunabilir olmalıdır.
  • Tür - Bu ayarın veri türü nedir? Dize, boole, tamsayı, dizi vb. mi?
  • Çakışma çözme stratejisi: Yöneticiler aynı anahtar için birden çok değer yapılandırırsa uygulamanız nasıl yanıt verir? Yukarıda bahsedilen tarayıcı örneğinde, bir yer imi listesi tüm değerleri birleştirebilirken, gizli modu devre dışı bırakmaya yönelik bir ayar, çakışan değerlerden herhangi biri "doğru" ise devre dışı bırakmayı seçebilir.

Uygulamam Yönetilen Cihazlar veya Yönetilen Uygulamalar için yapılandırmayı desteklemeli mi?

Yönetilen cihazlar için geçerli olan yapılandırmalar ve yönetilen uygulamalar için geçerli olan yapılandırmalar birbirini dışlamaz. Hangi yapılandırma türünü (veya her ikisini) destekleyeceğinize karar verirken kullanıcılarınızın gereksinimlerini göz önünde bulundurmalısınız.

Yapılandırma alanı Yönetilen cihazlar için yapılandırma Yönetilen uygulamalar için yapılandırma
Cihaz uygulanabilirliği Yalnızca Android Enterprise cihaz yönetimi altındaki cihazlarda geçerlidir. Uygulama, Intune Uygulama SDK'sını tümleştirdiği ve Şirket Portalı yüklü olduğu sürece tüm cihazlar için geçerlidir.
Ortam Yalnızca Android, Google hizmetlerine sahip cihazlarla sınırlıdır iOS Uygulama SDK'sı aynı yapılandırmaları destekler. Bir geliştirici olarak, tutarlı bir platformlar arası deneyim için bu anahtarları paylaşabilirsiniz.
Uygulanabilirlik Herhangi bir EMM Microsoft Intune'e özel
Şema bulunabilirliği Şema, uygulama Play'e yüklendikten sonra herkese açık hale gelir Geliştirici denetiminde şema bulunabilirliği

Her iki uygulama yapılandırması türü de anahtar-değer çiftlerine dayanır. Microsoft IntuneMicrosoft Intune bu yapılandırmaların içeriğini incelemez ve yalnızca yönetici tarafından yapılandırılan değerleri uygulamanıza geçirir.

TIntuneIntune Uygulama SDK'sı uygulama yapılandırma API'si her iki kanaldan da yönetici tarafından yapılandırılmış değerler içerir. Uygulamanız her iki uygulama yapılandırması türünü de destekliyorsa aşağıda açıklandığı gibi API'yi kullanın.

SDK'dan uygulama yapılandırması alınıyor

Uygulamalar, MAMAppConfigManager ve MAMAppConfig sınıflarını kullanarak her iki kanaldan da yapılandırmalar alabilir.

MAMAppConfigManager configManager = MAMComponents.get(MAMAppConfigManager.class);
String oid = <OID of user account>;
MAMAppConfig appConfig = configManager.getAppConfigForOID(oid);
String fooValue = appConfig.getStringForKey("foo", MAMAppConfig.StringQueryType.Any);

MAM'a kayıtlı bir hesap yoksa, ancak uygulamanız yine de Android Enterprise yapılandırma değerlerini (belirli bir hesabı hedeflemeyecek) almak istiyorsa, OID için bir null veya boş dize geçirebilirsiniz.

Not

Uygulamanız, Android Enterprise tarafından yönetilen yapılandırmaları almak için IntuneIntune Uygulama SDK'sını kullanıyorsa ve Şirket PortalıŞirket Portalı yüklü değilse, bu yapılandırmalar boş kimlikli bir MAMUserNotification aracılığıyla teslim edilir.

Uygulamanız, ham verileri belirli anahtarlara göre sorgulamak yerine anahtar-değer çiftleri kümelerinin bir listesi olarak da isteyebilir.

List<Map<String, String>> getFullData()

Uygulamanız, yeni uygulama yapılandırma verilerinin kullanılabilir olduğunu bildiren bildirime REFRESH_APP_CONFIG de kaydolabilir. Uygulamanız, uygulama yapılandırma verilerini önbelleğe alıyorsa, bu bildirim için kaydolmalı ve işleyicide önbelleğe alınmış tüm verileri geçersiz kılmalıdır . Daha fazla ayrıntı için SDK'dan gelen bildirimler için kaydolma bölümüne bakın.

Çatışmaları çözme

Birden çok uygulama yapılandırma ilkesi aynı uygulama ve hesabı hedefliyorsa, aynı anahtar için birden çok çakışan değer kullanılabilir.

Not

MAM uygulaması yapılandırmasında ayarlanan bir değer, Android Enterprise yapılandırmasında ayarlanan anahtara sahip bir değeri geçersiz kılar.

Bir yönetici aynı anahtar için çakışan değerleri yapılandırırsa, Intune bu çakışmayı otomatik olarak çözmenin bir yolu yoktur ve tüm değerleri uygulamanız için kullanılabilir hale getirir. Bu tür bir çakışma, yönetici aynı hesabı içeren birden çok gruba aynı anahtara sahip farklı uygulama yapılandırma kümelerini hedeflerse oluşabilir.

Uygulamanız bir MAMAppConfig nesnesinden belirli bir anahtar için tüm değerleri isteyebilir, böylece kendi iş mantığınızla çakışmaları çözebilirsiniz:

List<Boolean> getAllBooleansForKey(String key)
List<Long> getAllIntegersForKey(final String key)
List<Double> getAllDoublesForKey(final String key)
List<String> getAllStringsForKey(final String key)

Alternatif olarak, yerleşik çakışma çözme stratejilerinden biriyle bir değerin seçilmesini isteyebilirsiniz:

Boolean getBooleanForKey(String key, BooleanQueryType queryType)
Long getIntegerForKey(String key, NumberQueryType queryType)
Double getDoubleForKey(String key, NumberQueryType queryType)
String getStringForKey(String key, StringQueryType queryType)

Mevcut yerleşik çatışma çözme stratejileri şunları içerir:

  • BooleanQueryType.Any, BooleanQueryType.And, BooleanQueryType.Or
  • NumberQueryType.Any, NumberQueryType.Min, NumberQueryType.Max
  • StringQueryType.Any, StringQueryType.Min, StringQueryType.Maxburada min ve maks alfabetik sıralanmış bir listeden alınır.

Çıkış Kriterleri

IntuneIntune, uygulama yapılandırma ilkesi değerlerini uygulamanıza teslim etmekten sorumludur; daha sonra uygulamanız, uygulama içindeki davranışı veya kullanıcı arabirimini değiştirmek için bu değerleri kullanmaktan sorumludur. Kapsamlı uçtan uca testler her iki bileşeni de kapsamalıdır.

Intune uygulama yapılandırma ilkesini düzgün bir şekilde teslim ettiğini doğrulamak için:

  1. Uygulamanızı hedefleyen ve test hesabınıza dağıtılan bir uygulama yapılandırma ilkesi yapılandırın.
  2. Test hesabınızla uygulamanızda oturum açın.
  3. 's veya getFullData's getAppConfigForOID çağıran MAMAppConfigManagerher kod yolunu alıştırmak için uygulamanızda gezinin.
    • Kendisine yapılan aramaların getAppConfigForOID sonuçlarını günlüğe kaydetmek, hangi ayarların teslim edildiğini doğrulamanın basit bir yoludur. Ancak, yöneticiler uygulama yapılandırma ayarları için herhangi bir veri girebildiğinden, özel kullanıcı verilerini günlüğe kaydetmemeye dikkat edin.
  4. Bkz. Uygulanan uygulama yapılandırma ilkesini doğrulama.

Uygulama yapılandırmaları uygulamaya özgü olduğundan, uygulamanızın her uygulama yapılandırma ayarı için davranışını veya kullanıcı arabirimini nasıl değiştirmesi gerektiğini yalnızca siz bilirsiniz.

Test ederken aşağıdakileri göz önünde bulundurun:

  • Uygulamanızın desteklediği her değerle farklı test uygulaması yapılandırma ilkesi oluşturarak tüm senaryoların kapsandığından emin olun.
  • Her ayar için farklı değerlere sahip birden çok test uygulaması yapılandırma ilkesi oluşturarak uygulamanızın çakışma çözme mantığını doğrulama.
  • Uygulamanız bildirim için REFRESH_APP_CONFIG kaydolduysa, uygulamanız etkin kullanımdayken uygulama yapılandırma ilkesini güncelleştirir, ilkenin güncelleştirilmesini bekler ve bu kod yolunun düzgün kullanıldığını onaylar.
  • Uygulamanız her iki uygulama yapılandırması türünü de destekliyorsa, uygulamanızın doğru kimliği sağladığından emin olmak için her iki senaryoyu da test edin getAppConfigForOID.

Sonraki adımlar

Yukarıdaki tüm Çıkış Ölçütlerini tamamladıktan sonra, uygulamanız artık uygulama yapılandırma ilkesiyle olduğu gibi başarıyla tümleştirilir.

Sonraki bölüm olan Aşama 7: Uygulamaya Katılım Özellikleri, uygulamanızın istediği uygulama koruma ilkesi desteğine bağlı olarak gerekli olabilir veya olmayabilir. Bu özelliklerden herhangi birinin uygulamanız için geçerli olup olmadığından emin değilseniz, SDK entegrasyonu için Önemli Kararları tekrar ziyaret edin.

  • Last updated on