نمای کلی مانیفست برنامه

این بخش قراردادها و قوانینی را که عموماً برای همه عناصر و ویژگی‌های فایل مانیفست اعمال می‌شوند، توضیح می‌دهد.

عناصر

فقط عناصر <manifest> و <application> مورد نیاز است. هر کدام باید فقط یک بار رخ دهند. بسیاری از عناصر دیگر می توانند صفر یا چند بار رخ دهند. با این حال، برخی از آنها باید وجود داشته باشند تا فایل مانیفست مفید باشد.

همه مقادیر از طریق ویژگی ها تنظیم می شوند، نه به عنوان داده های کاراکتر در یک عنصر.

عناصر در همان سطح معمولاً مرتب نیستند. برای مثال، عناصر <activity> ، <provider> و <service> را می توان به هر ترتیبی قرار داد. دو استثنای کلیدی برای این قانون وجود دارد:

• عنصر <activity-alias> باید از <activity> که نام مستعار آن است پیروی کند.
• عنصر <application> باید آخرین عنصر درون عنصر <manifest> باشد.

صفات

از نظر فنی، همه ویژگی ها اختیاری هستند. با این حال، بسیاری از ویژگی ها باید مشخص شوند تا یک عنصر بتواند هدف خود را انجام دهد. برای ویژگی های واقعاً اختیاری، مستندات مرجع مقادیر پیش فرض را نشان می دهد.

به جز برخی از ویژگی‌های عنصر ریشه <manifest> ، همه نام‌های ویژگی با پیشوند android: شروع می‌شوند، مانند android:alwaysRetainTaskState . از آنجایی که پیشوند جهانی است، اسناد معمولاً هنگام ارجاع به ویژگی ها با نام آن را حذف می کنند.

مقادیر چندگانه

اگر بتوان بیش از یک مقدار را مشخص کرد، عنصر تقریباً همیشه تکرار می شود، نه اینکه چندین مقدار در یک عنصر فهرست شود. به عنوان مثال، یک فیلتر قصد می تواند چندین عمل را فهرست کند:

<intent-filter ... >
    <action android:name="android.intent.action.EDIT" />
    <action android:name="android.intent.action.INSERT" />
    <action android:name="android.intent.action.DELETE" />
    ...
</intent-filter>

ارزش های منابع

برخی از ویژگی ها دارای مقادیری هستند که به کاربران نمایش داده می شوند، مانند عنوان یک فعالیت یا نماد برنامه شما. مقدار این ویژگی‌ها ممکن است بر اساس زبان کاربر یا سایر پیکربندی‌های دستگاه متفاوت باشد (مانند ارائه یک اندازه نماد متفاوت بر اساس تراکم پیکسلی دستگاه)، بنابراین مقادیر باید از یک منبع یا موضوع تنظیم شوند، به‌جای اینکه به‌جای کدگذاری سخت در فایل مانیفست سپس مقدار واقعی می تواند بر اساس منابع جایگزینی که برای پیکربندی های مختلف دستگاه ارائه می کنید تغییر کند.

منابع به صورت مقادیر با فرمت زیر بیان می شوند:

"@[ package :] type / name "

اگر منبع توسط برنامه شما ارائه شده باشد، می توانید نام package را حذف کنید (از جمله اگر توسط یک وابستگی کتابخانه ارائه شده باشد، زیرا منابع کتابخانه با شما ادغام شده اند ). زمانی که می‌خواهید از منبعی از چارچوب Android استفاده کنید، تنها نام بسته معتبر دیگر android است.

type یک نوع منبع است، مانند string یا drawable ، و name ، نامی است که منبع خاص را مشخص می کند. در اینجا یک مثال است:

<activity android:icon="@drawable/smallPic" ... >

برای اطلاعات بیشتر درباره نحوه افزودن منابع به پروژه خود، نمای کلی منابع برنامه را بخوانید.

برای اعمال مقداری که در یک موضوع تعریف شده است، اولین کاراکتر باید ? به جای @ :

"?[ package :] type / name "

مقادیر رشته

در جایی که یک مقدار مشخصه یک رشته است، برای فرار از کاراکترها از دوبرابر معکوس ( \\ ) استفاده کنید، مانند \\n برای خط جدید یا \\uxxxx برای یک کاراکتر یونیکد.

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="1"
    android:versionName="1.0">

    <!-- Beware that these values are overridden by the build.gradle file -->
    <uses-sdk android:minSdkVersion="15" android:targetSdkVersion="26" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <!-- This name is resolved to com.example.myapp.MainActivity
             based on the namespace property in the build.gradle file -->
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <activity
            android:name=".DisplayMessageActivity"
            android:parentActivityName=".MainActivity" />
    </application>
</manifest>