<etkinlik>

Etkinliğin, özellikle çocuğun başka bir etkinliğe ait Display gibi bir kapsayıcıda yaşadığı durumlarda, başka bir etkinliğin yerleştirilmiş çocuğu olarak başlatılabileceğini gösterir. Örneğin, Wear özel bildirimleri için kullanılan etkinlikler, Wear'in etkinliği başka bir süreçte bulunan bağlam akışında gösterebilmesi için bunu bildirir.

Bu özelliğin varsayılan değeri false'dır.

Bu özellik ayarlanmazsa etkinlik için <application> öğesinin ilgili allowTaskReparenting özelliği tarafından ayarlanan değer geçerli olur. Varsayılan değer "false"'dır.

Normalde, bir etkinlik başlatıldığında, etkinliği başlatan göreve ilişkilendirilir ve ömrü boyunca orada kalır. Bu özelliği, mevcut görevi artık gösterilmediğinde görevin, ilişkili olduğu göreve yeniden atanmasını zorlamak için kullanabilirsiniz. Bu genellikle, bir uygulamanın etkinliklerinin söz konusu uygulamayla ilişkili ana göreve geçmesini sağlamak için kullanılır.

Örneğin, bir e-posta iletisinde web sayfasına yönelik bir bağlantı varsa bağlantıyı tıkladığınızda sayfayı görüntüleyebilecek bir etkinlik açılır. Bu etkinlik, tarayıcı uygulaması tarafından tanımlanır ancak e-posta görevinin bir parçası olarak başlatılır. Tarayıcı görevine yeniden üst öğe olarak atanırsa tarayıcı bir sonraki sefer öne geldiğinde gösterilir ve e-posta görevi tekrar öne geldiğinde gösterilmez.

Bir etkinliğin yakınlığı, taskAffinity özelliğiyle tanımlanır. Bir görevin yakınlığı, kök etkinliğinin yakınlığı okunarak belirlenir. Bu nedenle, tanım gereği bir kök etkinlik her zaman aynı yakınlığa sahip bir görevdedir. "singleTask" veya "singleInstance" başlatma modlarına sahip etkinlikler yalnızca bir görevin kök kısmında yer alabileceğinden yeniden üst öğe oluşturma işlemi "standard" ve "singleTop" modlarıyla sınırlıdır. (Ayrıca launchMode özelliğini de inceleyin.)

Normalde sistem, kullanıcının ana ekrandan bu görevi yeniden seçtiği belirli durumlarda bir görevi temizleyerek kök etkinliğin üzerindeki yığından tüm etkinlikleri kaldırır. Bu işlem genellikle kullanıcı, görevi belirli bir süre (ör. 30 dakika) boyunca ziyaret etmediğinde yapılır.

Ancak bu özellik "true" olduğunda kullanıcılar, nasıl ulaşmış olurlarsa olsunlar her zaman göreve son durumunda döner. Bu, kullanıcıların kaybetmek istemediği çok sayıda durumun (ör. birden fazla açık sekme) olduğu web tarayıcısı gibi uygulamalarda kullanışlıdır.

Sistem, Android TV ana ekranında bir uygulamayı temsil etmek için banner'ı kullanır. Banner yalnızca ana ekranda gösterildiğinden yalnızca CATEGORY_LEANBACK_LAUNCHER amacını işleyen bir etkinliğe sahip uygulamalar tarafından belirtilir.

Bu özellik, resmi içeren drawable kaynağa (ör. "@drawable/banner") referans olarak ayarlanır. Varsayılan banner yok.

Daha fazla bilgi için TV Uygulamalarını Kullanmaya Başlama bölümündeki Ana ekran banner'ı sağlama başlıklı makaleye bakın.

Etkinliğin, Android çalıştırıyor olabilecek veya olmayabilecek bir uzak cihazda gösterilip gösterilemeyeceğini belirtir. "true" veya "false" Boole değeri olmalıdır.

Bu özelliğin varsayılan değeri "true"'dır.

Değer "true" olduğunda, kullanıcılar göreve her başladıklarında, görevde en son ne yaptıkları ve görevden çıkmak için Geri veya Ana Sayfa düğmesini kullanıp kullanmadıklarına bakılmaksızın görevin kök etkinliğine yönlendirilir. Değer "false" olduğunda görev, bazı durumlarda etkinliklerden temizlenebilir ancak bu her zaman geçerli değildir. Daha fazla bilgi için alwaysRetainTaskState özelliğine bakın.

Kullanıcının ana ekrandan P etkinliğini başlattığını ve oradan Q etkinliğine gittiğini varsayalım. Kullanıcı daha sonra Ana Sayfa'ya dokunur ve P etkinliğine geri döner. Normalde kullanıcı, P'nin görevinde en son yaptığı işlem Q olduğu için Q etkinliğini görür. Ancak P bu işareti "true" olarak ayarlarsa kullanıcının ana ekrandan P etkinliğini başlatması durumunda P'nin üzerindeki tüm etkinlikler (bu örnekte Q) kaldırılır. Bu nedenle, kullanıcı göreve döndüğünde yalnızca P'yi görür.

Bu özellik ve allowTaskReparenting özelliği "true" ise yeniden üst öğe atanabilecek tüm aktiviteler, benzerlik paylaştıkları göreve taşınır. Geri kalan etkinlikler bırakılır.

FLAG_ACTIVITY_RESET_TASK_IF_NEEDED ayarlanmamışsa bu özellik yoksayılır.

Etkinliğin renk modunu belirtir. Belirtilmişse hdr veya wideColorGamut olabilir.

Cihaz destekliyorsa etkinliğin yüksek dinamik aralıkta gösterilmesini hdr ister.

wideColorGamut ise etkinliğin uyumlu cihazlarda geniş renk gamı modunda gösterilmesini ister. Geniş renk gamı modunda, bir pencere daha canlı renkler göstermek için SRGB gamının dışında oluşturulabilir. Cihaz geniş renk gamı oluşturmayı desteklemiyorsa bu özelliğin etkisi olmaz. Geniş renk modunda oluşturma hakkında daha fazla bilgi için Geniş renkli içeriğe sahip grafikleri iyileştirme başlıklı makaleyi inceleyin.

Not: Bu özelliği yalnızca özel durumlarda uygulama performansını ve yanıt verme hızını artırmak için kullanın. Daha fazla bilgi için Yapılandırma değişikliklerini işleme başlıklı makaleyi inceleyin.

Aşağıdaki dizeler, bu özellik için geçerli değerlerdir. Birden fazla değer | ile ayrılır (ör. "locale|navigation|orientation").

Bu yapılandırma değişikliklerinin tümü, uygulama tarafından görülen kaynak değerlerini etkileyebilir. Bu nedenle, onConfigurationChanged() çağrıldığında değişikliğin doğru şekilde işlenmesi için görünüm düzenleri ve çizilebilir öğeler de dahil olmak üzere tüm kaynakların tekrar alınması genellikle gerekir.

Not: Çoklu pencere ile ilgili yapılandırma değişikliklerini işlemek için hem "screenLayout" hem de "smallestScreenSize" kullanın. Çoklu pencere özelliği, Android 7.0 (API düzeyi 24) veya sonraki sürümlerde desteklenir.

Etkinliğin Direct-Boot aware (Doğrudan Başlatma'ya duyarlı) olup olmadığı, yani kullanıcının cihazın kilidini açmasından önce çalışıp çalışamayacağı.

Not: Doğrudan başlatma sırasında uygulamanızdaki bir etkinlik yalnızca cihaz korumalı depolama alanında saklanan verilere erişebilir.

Varsayılan değer "false"'dır.

Bu özelliğin dört değeri vardır. Kullanıcı, uygulamayla bir doküman açtığında aşağıdaki etkiler oluşur:

Not: "none" ve "never" dışındaki değerler için etkinlik, launchMode="standard" ile tanımlanır. Bu özellik belirtilmezse documentLaunchMode="none" kullanılır.

<application> öğesinin, aktiviteler de dahil olmak üzere tüm uygulama bileşenleri için geçerli olan kendi enabled özelliği vardır. Sistemin etkinliği başlatabilmesi için <application> ve <activity> özelliklerinin her ikisinin de "true" olması gerekir. Bu özellikler varsayılan olarak "true"'dir. İkisi de "false" ise örneklenemez.

Bu işaret, etkinlik düzeyinde tahmine dayalı sistem animasyonlarını devre dışı bırakmanıza olanak tanır.

Etkinlik düzeyinde tahmin edilen geri gitme animasyonlarını devre dışı bırakmak ve sisteme OnBackInvokedCallback platform API'sine yapılan çağrıları yoksaymasını söylemek için android:enableOnBackInvokedCallback=false değerini ayarlayın.

Bu etkinlik tarafından başlatılan görevin Son Kullanılanlar ekranından hariç tutulup tutulmadığı. Yani bu etkinlik yeni bir görevin kök etkinliği olduğunda bu özellik, görevin son kullanılan uygulamalar listesinde görünüp görünmeyeceğini belirler. Görev listeden hariç tutulmuşsa "true", dahil edilmişse "false" gösterilir. Varsayılan değer "false"'dır.

Etkinliğin diğer uygulamaların bileşenleri tarafından başlatılıp başlatılamayacağı:

• Değer "true" ise etkinliğe herhangi bir uygulama erişebilir ve tam sınıf adıyla başlatılabilir.
• "false" ise etkinlik yalnızca aynı uygulamanın bileşenleri, aynı kullanıcı kimliğine sahip uygulamalar veya ayrıcalıklı sistem bileşenleri tarafından başlatılabilir. Amaç filtresi yoksa varsayılan değer budur.

Uygulamanızdaki bir etkinlikte intent filtreleri varsa diğer uygulamaların etkinliği başlatmasına izin vermek için bu öğeyi "true" olarak ayarlayın. Örneğin, etkinlik uygulamanın ana etkinliğiyse ve category içeriyorsa android.intent.category.LAUNCHER.

Bu öğe "false" olarak ayarlanırsa ve bir uygulama etkinliği başlatmaya çalışırsa sistem ActivityNotFoundException oluşturur.

Bu özellik, bir etkinliğin diğer uygulamalardaki görünürlüğünü sınırlamanın tek yolu değildir. İzinler, etkinliği çağırabilecek harici öğeleri sınırlamak için de kullanılır. permission özelliğini inceleyin.

Bu özellik ve allowTaskReparenting özellikleri "true" ise bu özellik diğerini geçersiz kılar. Etkinliğin yakınlığı yoksayılır. Etkinlik yeniden üst öğe olarak atanmaz, ancak yok edilir.

FLAG_ACTIVITY_RESET_TASK_IF_NEEDED ayarlanmamışsa bu özellik yoksayılır.

Android 3.0 ve sonraki sürümlerde, birçok yaygın 2D grafik işleminin performansını artırmak için uygulamalarda donanım hızlandırmalı OpenGL oluşturucu kullanılabilir. Donanım hızlandırmalı oluşturucu etkinleştirildiğinde Canvas, Paint, Xfermode, ColorFilter, Shader ve Camera'daki çoğu işlem hızlandırılır.

Bu sayede, çerçevenin OpenGL kitaplıklarını açıkça kullanmayan uygulamalarda bile daha akıcı animasyonlar, daha akıcı kaydırma ve genel olarak daha iyi yanıt verme özelliği elde edilir. Donanım hızlandırmayı etkinleştirmek için daha fazla kaynak gerektiğinden uygulamanız daha fazla RAM tüketir.

OpenGL 2D işlemlerinin tümü hızlandırılmaz. Donanım hızlandırmalı oluşturucuyu etkinleştirirseniz uygulamanızın oluşturucuyu hatasız kullanıp kullanamadığını test edin.

Etkinliği temsil eden bir simge. Simge, ekranda etkinliğin gösterilmesi gerektiğinde kullanıcılara gösterilir. Örneğin, görevleri başlatan etkinliklerin simgeleri başlatıcı penceresinde gösterilir. Simgeye genellikle bir etiket eşlik eder. Etiket hakkında bilgi için android:label özelliğine bakın.

Bu özellik, resim tanımını içeren drawable kaynağa referans olarak ayarlanır. Ayarlanmamışsa bunun yerine uygulamanın tamamı için belirtilen simge kullanılır. Daha fazla bilgi için <application> öğesinin icon özelliğine bakın.

Burada veya <application> öğesi tarafından ayarlanan etkinliğin simgesi, aynı zamanda etkinliğin tüm amaç filtrelerinin varsayılan simgesidir. Daha fazla bilgi için <intent-filter> öğesinin icon özelliğine bakın.

Sistemin gelen amaçları uygulama bileşenleriyle nasıl eşleştirdiğine ince ayar yapmak için bu özelliği kullanın. Varsayılan olarak özel eşleşme kuralları uygulanmaz.

<activity> etiketinde ayarlanan değer, <application> etiketinde ayarlanan değeri geçersiz kılar.

Değer, "|" ile ayrılmış aşağıdaki işaretlerden biri veya daha fazlası olmalıdır:

Daha fazla bilgi için Android 16'daki (API düzeyi 36) davranış değişiklikleri bölümündeki Daha Güvenli Amaçlar'a göz atın.

Etkinlik için kullanıcı tarafından okunabilir bir etiket. Etkinlik kullanıcıya gösterildiğinde ekranda etiket görüntülenir. Genellikle etkinlik simgesiyle birlikte gösterilir. Bu özellik ayarlanmazsa bunun yerine uygulamanın tamamı için ayarlanan etiket kümesi kullanılır. <application> öğesinin label özelliğine bakın.

Etkinliğin etiketi (burada veya <application> öğesi tarafından ayarlanmış olsun) aynı zamanda etkinliğin tüm amaç filtrelerinin varsayılan etiketidir. Daha fazla bilgi için <intent-filter> öğesinin label özelliğine bakın.

Etiket, bir dize kaynağına referans olarak ayarlanır. Böylece, kullanıcı arayüzündeki diğer dizeler gibi yerelleştirilebilir. Ancak uygulamayı geliştirirken kolaylık sağlaması için ham dize olarak da ayarlanabilir.

Etkinliğin nasıl başlatılacağıyla ilgili talimat. Etkinlik bir intent'i işlemek için çağrıldığında ne olacağını belirlemek üzere Intent nesnelerindeki etkinlik işaretleriyle (FLAG_ACTIVITY_* sabitleri) birlikte çalışan beş mod vardır:

"standard"
"singleTop"
"singleTask"
"singleInstance"
"singleInstancePerTask"

Varsayılan mod "standard"'dir.

Aşağıdaki tabloda gösterildiği gibi, modlar iki ana grupta yer alır. Bir tarafta "standard" ve "singleTop" etkinlikleri, diğer tarafta ise "singleTask", "singleInstance" ve "singleInstancePerTask" etkinlikleri bulunur. "standard" veya "singleTop" başlangıç moduna sahip bir etkinlik birden çok kez örneklenebilir.

Örnekler herhangi bir göreve ait olabilir ve etkinlik görevinde herhangi bir yerde bulunabilir. Genellikle, startActivity() nesnesi bir FLAG_ACTIVITY_NEW_TASK talimatı içermediği sürece Intent'ı çağıran görevde başlatılır. Bu durumda farklı bir görev seçilir. Daha fazla bilgi için taskAffinity özelliğine bakın.

Buna karşılık, "singleTask", "singleInstance" ve "singleInstancePerTask" etkinlikleri farklı davranışlara sahiptir. "singleInstancePerTask" her zaman etkinlik görevinin temelinde yer alır. Ayrıca, cihaz aynı anda yalnızca bir "singleInstance" etkinliği örneği tutabilir. FLAG_ACTIVITY_MULTIPLE_TASK veya FLAG_ACTIVITY_NEW_DOCUMENT ayarlandığında ise "singleInstancePerTask etkinliği farklı görevlerde birden çok kez başlatılabilir.

"singleTask" başlangıç moduna sahip bir etkinlik, "singleInstance" ve "singleInstancePerTask" davranışlarını birleştirir: Etkinlik birden çok kez örneklenebilir ve aynı taskAffinity görevinde herhangi bir yerde bulunabilir. Ancak cihaz, etkinlik görevinin kökündeki "singleTask" etkinliğini bulmak için yalnızca bir görev tutabilir.

"standard" ve "singleTop" modları bir açıdan birbirinden farklıdır: "standard" etkinliği için her yeni amaç olduğunda, bu amaca yanıt vermek üzere sınıfın yeni bir örneği oluşturulur. Her örnek tek bir amaca hizmet eder. Benzer şekilde, yeni bir amaçla ilgilenmek için "singleTop" etkinliğinin yeni bir örneği de oluşturulabilir.

Ancak hedef görevde yığının en üstünde etkinliğin mevcut bir örneği varsa bu örnek, onNewIntent() çağrısında yeni amacı alır. Yeni bir örnek oluşturulmaz. Aksi takdirde ("singleTop" etkinliğinin mevcut bir örneği hedef görevde ancak yığının en üstünde değilse veya yığının en üstünde ancak hedef görevde değilse) yeni bir örnek oluşturulur ve yığına gönderilir.

Benzer şekilde, kullanıcı mevcut yığında bir etkinliğe yukarı doğru gezinirse davranış, üst etkinliğin başlatma modu tarafından belirlenir. Üst etkinliğin başlangıç modu singleTop ise (veya up intent FLAG_ACTIVITY_CLEAR_TOP içeriyorsa) üst öğe yığının en üstüne getirilir ve durumu korunur.

Gezinme amacı, üst etkinliğin onNewIntent() yöntemi tarafından alınır. Üst etkinliğin başlangıç modu standard ise ve up amaç FLAG_ACTIVITY_CLEAR_TOP içermiyorsa mevcut etkinlik ve üst öğesi yığından çıkarılır ve gezinme amacını almak için üst etkinliğin yeni bir örneği oluşturulur.

"singleInstance" başlangıç modu, "singleTask" ve "singleInstancePerTask" başlangıç modlarından yalnızca bir açıdan farklıdır: "singleTask" veya "singleInstancePerTask" başlangıç moduna sahip bir etkinlik, diğer etkinliklerin (zorunlu olarak "standard" ve "singleTop" etkinlikleri) görevinin bir parçası olmasına izin verir.

A "singleInstance" etkinliği ise başka hiçbir etkinliğin görevine dahil edilmesine izin vermez. Görevdeki tek etkinlik olmalıdır. Başka bir etkinlik başlatırsa bu etkinlik, niyetin içinde FLAG_ACTIVITY_NEW_TASK varmış gibi farklı bir göreve atanır.

Önceki tabloda gösterildiği gibi, "standard" varsayılan moddur ve çoğu etkinlik türü için uygundur. "singleTop", birçok etkinlik türü için yaygın ve faydalı bir başlangıç modudur. Diğer modlar olan "singleTask", "singleInstance" ve "singleInstancePerTask" çoğu uygulama için uygun değildir. Bu durum, kullanıcıların büyük olasılıkla yabancı olduğu ve diğer birçok uygulamadan çok farklı bir etkileşim modeliyle sonuçlanır.

Seçtiğiniz başlangıç modundan bağımsız olarak, lansman sırasında ve Geri düğmesini kullanarak diğer etkinliklerden ve görevlerden geri dönerken etkinliğin kullanılabilirliğini test ettiğinizden emin olun.

Lansman modları ve Intent işaretlerle etkileşimleri hakkında daha fazla bilgi için Görevler ve geri yığın başlıklı makaleyi inceleyin.

Android, görevleri yoğun içerik modunda ve kiosk benzeri bir şekilde (görev kilitleme modu) çalıştırabilir. Sistem, görev kilitleme modunda çalışırken cihaz kullanıcıları genellikle bildirimleri göremez, izin verilenler listesinde olmayan uygulamalara erişemez veya ana ekran uygulaması izin verilenler listesine eklenmediyse ana ekrana dönemez.

Sistem görev kilitleme modundayken yalnızca bir cihaz politikası denetleyicisi (DPC) tarafından izin verilen uygulamalar çalıştırılabilir. Ancak sistem ve ayrıcalıklı uygulamalar, izin verilenler listesine eklenmeden görev kilitleme modunda çalışabilir.

Değer, aşağıdaki R.attr.lockTaskMode dize değerlerinden herhangi biri olabilir:

Bu özellik, API düzeyi 23'te kullanıma sunulmuştur.

Etkinliğin desteklediği maksimum en-boy oranı.

Uygulama, daha geniş bir en-boy oranına sahip cihazda çalışıyorsa sistem, uygulamayı otomatik olarak letterbox yapar. Bu sayede ekranın bir kısmı kullanılmaz ve uygulama, belirtilen maksimum en-boy oranında çalışabilir.

Maksimum en boy oranı, cihazın uzun boyutunun kısa boyutuna bölünmesiyle elde edilen bölümün ondalık biçimi olarak ifade edilir. Örneğin, maksimum en-boy oranı 7:3 ise bu özelliğin değerini 2,33 olarak ayarlayın.

Giyilebilir olmayan cihazlarda bu özelliğin değeri 1, 33 veya daha yüksek olmalıdır. Giyilebilir cihazlarda 1.0 veya sonraki bir sürüm olmalıdır. Aksi takdirde sistem, ayarlanan değeri yoksayar.

Bu özellik hakkında daha fazla bilgi için R.attr.maxAspectRatio sayfasına bakın.

Etkinliğin desteklediği minimum en-boy oranı.

Uygulama, daha dar bir en-boy oranına sahip cihazda çalışıyorsa sistem, uygulamayı otomatik olarak letterbox yapar. Böylece ekranın bir kısmı kullanılmaz ve uygulama, belirtilen minimum en-boy oranında çalışabilir.

Minimum en boy oranı, cihazın uzun boyutunun kısa boyutuna bölünmesiyle elde edilen bölümün ondalık biçimi olarak ifade edilir. Örneğin, görüntü en boy oranı 4:3 ise minimum en boy oranı değerini 1, 33 olarak ayarlayın.

Değer 1,0 veya daha büyük olmalıdır.Aksi takdirde sistem, ayarlanan değeri yoksayar.

Bu özellik hakkında daha fazla bilgi için R.attr.minAspectRatio konusuna bakın.

Normalde, bir etkinliğin yeni örneği, onu tanımlayan uygulamanın sürecinde başlatılır. Bu nedenle, etkinliğin tüm örnekleri aynı süreçte çalışır. Ancak bu işaret "true" olarak ayarlanırsa etkinliğin örnekleri birden fazla işlemde çalışabilir. Bu da sistemin, izinler izin verdiği sürece kullanıldıkları her yerde örnek oluşturmasına olanak tanır. Bu durum neredeyse hiçbir zaman gerekli veya istenen bir durum değildir.

Uygulamanızı yayınladıktan sonra android:exported="false" ayarını yapmadığınız sürece bu adı değiştirmeyin. Varsayılan değer yoktur. Ad belirtilmelidir.

"true" değeri, etkinliğin geçmişe dönük iz bırakmadığı anlamına gelir. Görev için etkinlik yığınında kalmaz. Bu nedenle kullanıcı, göreve geri dönemez. Bu durumda, bu etkinlikten sonuç almak için başka bir etkinlik başlatırsanız onActivityResult() hiçbir zaman çağrılmaz.

Bu özellik, API düzeyi 3'te kullanıma sunulmuştur.

Sistem, kullanıcı işlem çubuğundaki Yukarı düğmesine dokunduğunda hangi etkinliğin başlatılacağını belirlemek için bu özelliği okur. Sistem, bu bilgileri TaskStackBuilder ile etkinliklerin geri yığınını sentezlemek için de kullanabilir.

API seviyeleri 4-16'yı desteklemek için üst etkinliği <meta-data> öğesiyle de bildirebilirsiniz. Bu öğe, "android.support.PARENT_ACTIVITY" için bir değer belirtir:

<activity
    android:name="com.example.app.ChildActivity"
    android:label="@string/title_child_activity"
    android:parentActivityName="com.example.app.MainActivity" >
    <!-- Parent activity meta-data to support API level 4+ -->
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value="com.example.app.MainActivity" />
</activity>

Üst gezinmeyi desteklemek için üst etkinliği bildirme hakkında daha fazla bilgi edinmek istiyorsanız Üst gezinme sağlama başlıklı makaleyi inceleyin.

Bu özellik, API düzeyi 16'da kullanıma sunulmuştur.

Bir etkinliğin örneğinin, cihaz yeniden başlatıldığında kapsayan görev içinde nasıl korunacağını tanımlar.

Bir görevin kök etkinliği bu özelliğin değerini persistRootOnly olarak ayarlarsa yalnızca kök etkinlik korunur. Aksi takdirde, görevin geri yığınında daha yukarıda bulunan etkinlikler incelenir. Bu özelliğin değerini persistAcrossReboots olarak ayarlayan etkinlikler korunur.

Bu özelliği kullanıyorsanız değerini aşağıdakilerden biri olarak ayarlamanız gerekir:

Bu özellik, API düzeyi 21'de kullanıma sunulmuştur.

Bu özellik ayarlanmazsa <application> öğesinin permission özelliği tarafından ayarlanan izin, etkinlik için geçerli olur. İki özellik de ayarlanmamışsa etkinlik izinle korunmaz.

İzinler hakkında daha fazla bilgi için Uygulama manifestine genel bakış bölümündeki İzinler ve Güvenlik ipuçları başlıklı makaleleri inceleyin.

Etkinliğin çalıştığı sürecin adı. Normalde, bir uygulamanın tüm bileşenleri uygulama için oluşturulan varsayılan bir işlem adında çalışır ve bu özelliği kullanmanız gerekmez. Ancak gerekirse bu özelliği kullanarak varsayılan işlem adını geçersiz kılabilir ve uygulama bileşenlerinizi birden fazla işleme yayabilirsiniz.

Bu özelliğe atanan ad iki nokta üst üste işaretiyle (:) başlıyorsa gerektiğinde uygulamaya özel yeni bir işlem oluşturulur ve etkinlik bu işlemde çalışır.

İşlem adı küçük harfle başlıyorsa etkinlik, bu ada sahip genel bir işlemde çalışır (bunun için gerekli izne sahip olması koşuluyla). Bu sayede farklı uygulamalardaki bileşenler bir işlemi paylaşabilir ve kaynak kullanımı azaltılabilir.

<application> öğesinin process özelliği, tüm bileşenler için farklı bir varsayılan işlem adı ayarlayabilir.

Etkinliğin, görev yığınında kendisinin üstünde bulunan bir etkinliğe görev tanımlayıcılarını bırakıp bırakmadığı. Kök etkinliğinde bu özellik "true" olarak ayarlanmış bir görev, temel Intent öğesini görevdeki sonraki etkinliğin Intent öğesiyle değiştirir.

Bir sonraki etkinlikte de bu özellik "true" olarak ayarlanmışsa aynı görevde başlattığı tüm etkinliklere temel Intent değerini verir. Bu işlem, "false" olarak ayarlanmış bu özelliğe sahip bir etkinlikle karşılaşılana kadar her etkinlik için devam eder. Varsayılan değer "false"'dır.

Bu özellik "true" olarak ayarlandığında, etkinliğin ActivityManager.TaskDescription kullanarak Son Kullanılanlar ekranındaki etiketleri, renkleri ve simgeleri değiştirmesine de izin verilir.

İçerik URI'leri iletilirken bu etkinliğin başlatılması için gerekli izinleri belirtir. Varsayılan değer none şeklindedir. Bu, belirli bir izin gerekmediği anlamına gelir. Bu özelliği ayarlamak, etkinliğin başlatılmasını başlatanın izinlerine göre kısıtlar. Çağıran kullanıcının gerekli izinleri yoksa etkinlik başlatma işlemi SecurityException aracılığıyla reddedilir.

Bu yaptırımın, Intent.getData(), Intent.EXTRA_STREAM ve Intent.getClipData() içindeki içerik URI'leri için geçerli olduğunu unutmayın.

Unicode karakter için "\\n" veya "\\uxxxx" gibi karakterlerin kod dışına alınması amacıyla "\\;" kullanılan bir dize değeri olabilir.

Aşağıdaki sabit değerlerden biri olmalıdır.

Uygulamanın çoklu pencere modunu destekleyip desteklemediğini belirtir.

Bu özelliği <activity> veya <application> öğesinde ayarlayabilirsiniz.

Bu özelliği "true" olarak ayarlarsanız kullanıcı, etkinliği bölünmüş ekran ve serbest biçim modlarında başlatabilir. Özelliği "false" olarak ayarlarsanız uygulama, çok pencereli bir ortamda test edilemez veya optimize edilemez. Sistem, uyumluluk modu uygulandığında etkinliği çoklu pencere moduna yerleştirmeye devam edebilir.

Bu özelliği "false" olarak ayarlamak, pencere içinde pencere veya diğer ekranlarda olduğu gibi, çoklu pencere modunda ekranda başka uygulamaların görünmediğini garanti etmez. Bu nedenle, bu işareti ayarlamak uygulamanızın özel kaynak erişimine sahip olduğu anlamına gelmez.

Uygulamanız API düzeyi 24 veya sonraki sürümleri hedefliyorsa ve bu özellik için bir değer belirtmezseniz özelliğin değeri varsayılan olarak "true" olur.

Uygulamanız API düzeyi 31 veya üstünü hedefliyorsa bu özellik, küçük ve büyük ekranlarda farklı şekilde çalışır:

• Büyük ekranlar (sw >= 600 dp): Tüm uygulamalar çoklu pencere modunu destekler. Bu özellik, uygulamanın çoklu pencere modunu destekleyip desteklemediğini değil, yeniden boyutlandırılıp boyutlandırılamayacağını gösterir. resizeableActivity="false" ise uygulama, ekran boyutlarına uymak için gerektiğinde uyumluluk moduna alınır.
• Küçük ekranlar (sw < 600 dp): resizeableActivity="true" ve etkinliğin minimum genişliği ile minimum yüksekliği çoklu pencere şartları dahilindeyse uygulama, çoklu pencere modunu destekler. resizeableActivity="false" ise uygulama, etkinliğin minimum genişliği ve yüksekliğinden bağımsız olarak çok pencereli modu desteklemez.

Bir görevin kök etkinlik değeri, görevde başlatılan tüm ek etkinliklere uygulanır. Yani bir görevin kök etkinliği yeniden boyutlandırılabilirse sistem, görevdeki diğer tüm etkinlikleri yeniden boyutlandırılabilir olarak değerlendirir. Kök etkinlik yeniden boyutlandırılamıyorsa görevdeki diğer etkinlikler de yeniden boyutlandırılamaz.

Not: Bir görevin kök etkinlik değeri, görevde başlatılan tüm ek etkinliklere uygulanır. Yani bir görevin kök etkinliği yeniden boyutlandırılabilirse sistem, görevdeki diğer tüm etkinlikleri yeniden boyutlandırılabilir olarak değerlendirir. Kök etkinlik yeniden boyutlandırılamıyorsa görevdeki diğer etkinlikler de yeniden boyutlandırılamaz.

Etkinliğin istenen yönü.

Bir etkinlik tüm ekranı kapladığında, istenen yön, o ekrandaki yönün istenen değerle eşleşecek şekilde değiştirilmesi için bir öneri olarak kabul edilir. Bu durum, ekranın uzaydaki fiziksel yönünden farklı bir yönlendirmeye neden olabilir ve kullanıcının uygulamayı kullanmaya devam etmek için cihazı döndürmesini gerektirebilir. Android 12 (API düzeyi 31) ve sonraki sürümlerde cihaz üreticileri, tek tek cihaz ekranlarını (ör. katlanabilir cihazların tablet boyutundaki ekranı) bu öneriyi yoksayacak şekilde yapılandırabilir ve bunun yerine bir etkinliğin, kullanıcının tercih ettiği cihaz yönünde letterbox'a alınmasını zorunlu kılabilir. Bu sayede, kullanıcının cihazını fiziksel olarak döndürmesine gerek kalmadan etkinliğin yönü istenen yöne uygun hale gelir.

Çok pencereli modda, istenen yönlendirme genel yönlendirme için öneri olarak kullanılmaz. Etkinlik sinemaskop ise istenen yön, etkinliğe uygulanan sinemaskopu etkiler.

Değer, aşağıdaki dizelerden herhangi biri olabilir:

Not: Yatay veya dikey değerlerden birini bildirdiğinizde bu, etkinliğin çalıştırıldığı yön için zorunlu bir koşul olarak kabul edilir. Bildirdiğiniz değer, Google Play gibi hizmetler tarafından filtrelemeye olanak tanır. Böylece uygulamanız yalnızca etkinliklerinizin gerektirdiği yönlendirmeyi destekleyen cihazlarda kullanılabilir. Örneğin, "landscape", "reverseLandscape" veya "sensorLandscape" değerlerinden birini beyan ederseniz uygulamanız yalnızca yatay yönü destekleyen cihazlarda kullanılabilir.

Ayrıca, uygulamanızın <uses-feature> öğesiyle dikey veya yatay yön gerektirdiğini açıkça beyan edin. Örneğin: <uses-feature android:name="android.hardware.screen.portrait"/>. Bu, Google Play ve bunu destekleyen diğer hizmetler tarafından sağlanan bir filtreleme davranışıdır. Platformun kendisi, bir cihaz yalnızca belirli yönleri desteklediğinde uygulamanızın yüklenip yüklenemeyeceğini kontrol etmez.

Etkinliğin, cihazın mevcut kullanıcısı etkinliği başlatan kullanıcıdan farklı olduğunda gösterilip gösterilmeyeceği. Bu özelliği "true" veya "false" gibi bir değişmez değere ayarlayabilir ya da özelliği, boole değeri içeren bir kaynak veya tema özelliğine ayarlayabilirsiniz.

Bu özellik, API düzeyi 23'te eklendi.

Normalde, kaynak tasarrufu için bir etkinlik geçici olarak kapatılmadan önce onSaveInstanceState() yöntemi çağrılır. Bu yöntem, etkinliğin mevcut durumunu bir Bundle nesnesinde saklar. Bu nesne, etkinlik yeniden başlatıldığında onCreate()'ye iletilir. Bu özellik "true" olarak ayarlanırsa onSaveInstanceState() çağrılmayabilir ve Bundle yerine onCreate() iletilir. Bu durum, etkinlik ilk kez başladığında da geçerlidir.null

"true" ayarı, etkinliğin durum korunmadan yeniden başlatılabileceği anlamına gelir. Örneğin, ana ekranı gösteren etkinlik, bu ayarı kullanarak herhangi bir nedenle kilitlenirse kaldırılmamasını sağlar.

Etkinliğin pencere içinde pencere görüntülemeyi destekleyip desteklemediğini belirtir.

Etkinliğin yakınlık duyduğu görev. Aynı yakınlığa sahip etkinlikler, kavramsal olarak aynı göreve, kullanıcı açısından aynı "uygulamaya" aittir. Bir görevin yakınlığı, kök etkinliğinin yakınlığıyla belirlenir.

Benzerlik, iki şeyi belirler: etkinliğin yeniden üst öğe olarak atandığı görev (allowTaskReparenting özelliğine bakın) ve FLAG_ACTIVITY_NEW_TASK işaretiyle başlatıldığında etkinliğin bulunduğu görev.

Varsayılan olarak, bir uygulamadaki tüm etkinlikler aynı yakınlığa sahiptir. Bu özelliği, etkinlikleri farklı şekilde gruplandırmak ve hatta farklı uygulamalarda tanımlanan etkinlikleri aynı göreve yerleştirmek için ayarlayabilirsiniz. Etkinliğin herhangi bir görevle ilişkisi olmadığını belirtmek için boş bir dize olarak ayarlayın.

Bu özellik ayarlanmazsa etkinlik, uygulama için ayarlanan yakınlığı devralır. <application> öğesinin taskAffinity özelliğine bakın. Bir uygulama için varsayılan yakınlığın adı, build.gradle dosyasında ayarlanan ad alanıdır.

Bu özellik ayarlanmamışsa etkinlik, uygulamanın tamamı için ayarlanan temayı <application> öğesinin theme özelliğinden devralır. Bu özellik de ayarlanmamışsa varsayılan sistem teması kullanılır. Daha fazla bilgi için Stiller ve temalar başlıklı makaleyi inceleyin.

Bir etkinliğin kullanıcı arayüzü için ek seçenekler. Aşağıdaki değerlerden biri olmalıdır.

Uygulama çubuğu hakkında daha fazla bilgi için Uygulama çubuğunu ekleme başlıklı makaleyi inceleyin.

Bu özellik, API düzeyi 14'te eklendi.

• Etkinlik, kullanıcının dikkatini çektiğinde sanal klavyenin gizli mi yoksa görünür mü olduğu.
• Etkinliğin ana penceresinin, sanal klavyeye yer açmak için daha küçük boyuta getirilmesi veya pencerenin bir kısmı sanal klavye tarafından kapatıldığında mevcut odağı görünür kılmak için içeriğinin kaydırılması.

Ayar, aşağıdaki tabloda listelenen değerlerden biri veya bir "state..." değeri ile bir "adjust..." değerinin kombinasyonu olmalıdır. Gruplardan birinde birden fazla değer (ör. birden fazla "state..." değeri) ayarlamak, sonuçların tanımlanmamasına neden olur. Tek tek değerler, aşağıdaki örnekte gösterildiği gibi dikey çubukla (|) ayrılır:

<activity android:windowSoftInputMode="stateVisible|adjustResize" ... >

Burada ayarlanan değerler ("stateUnspecified" ve "adjustUnspecified" hariç), temada ayarlanan değerleri geçersiz kılar.

Bu özellik, API düzeyi 3'te kullanıma sunulmuştur.