Info.plist: nədir, məcburi açarlar və işə salma parametrləri

Info.plist nədir

Info.plist, property list şəklində açar-dəyər cütlərini ehtiva edən XML formatında dict kök elementi olan fayldır. Tətbiq paketinin içərisində yerləşir və hər işə salınmada kod icra olunmazdan əvvəl sistem tərəfindən oxunur. Plist formatı sətirləri, rəqəmləri, massivləri, lüğətləri, tarixləri və boolean dəyərləri dəstəkləyir ki, bu da mürəkkəb konfiqurasiyaları təsvir etməyə imkan verir.

Apple Info.plist-dən tətbiqin kimliyini, imkanlarını və tələblərini müəyyən etmək üçün istifadə edir. Bəzi açarların dəyişdirilməsi paketin yenidən qurulmasını tələb edir, çünki onlar qurma yüklənərkən App Store tərəfindən yoxlanılan metadatalara təsir edir. Məsələn, nəşrdən sonra CFBundleVersion və ya CFBundleIdentifier dəyişdirilməsi tətbiq yeniləmə prosesini poza bilər, çünki App Store Connect versiyaları identifikasiya etmək üçün bu dəyərlərdən istifadə edir.

Əsas açarlar Xcode-da layihə yaradılarkən avtomatik yaradılır, lakin əksər parametrlər tətbiq funksionallığı inkişaf etdikcə əl ilə əlavə edilir. Xcode standart açarlar üçün açılan siyahıları olan qrafik Info.plist redaktoru təqdim edir ki, bu da səhv yazma riskini azaldır. Bununla belə, Scene Manifest və ya Background Modes kimi mürəkkəb konfiqurasiyalar üçün mənbə XML-ni birbaşa redaktə etmək tövsiyə olunur.

Məcburi Info.plist açarları

Bəzi Info.plist açarları App Store-da nəşr üçün məcburidir. Onların olmaması yoxlama mərhələsində qurmanın rədd edilməsinə səbəb olur. Apple Xcode Organizer və ya Transporter vasitəsilə arxiv yüklənərkən bu açarları avtomatik yoxlayır. Tərtibatçı baxışa göndərməzdən əvvəl bütün məcburi sahələrin düzgün doldurulduğuna əmin olmalıdır.

Paket identifikatorları

CFBundleIdentifier açarı tətbiqin unikal identifikatorunu tərs domen qeydində (com.shirkət.tətbiq) təyin edir. O, kod imzalanması, Push bildirişləri, CloudKit, App Groups və bir çox digər Apple xidmətləri üçün istifadə olunur. Nəşrdən sonra identifikatorun dəyişdirilməsi App Store tərəfindən yeni tətbiq kimi qəbul edilir və mövcud istifadəçilər yeniləmə almır. Buna görə identifikator tətbiqin bütün həyat dövrü ərzində dəyişməz olmalıdır.

<key>CFBundleIdentifier</key>
<string>com.itsectr.myapp</string>

Tətbiq versiyası

CFBundleShortVersionString (göstərilən versiya) və CFBundleVersion (qurma nömrəsi) açarları App Store Connect və sistem tərəfindən yeniləmələri idarə etmək üçün istifadə olunur. Versiya major.minor.patch formatında göstərilir. Qurma nömrəsi App Store Connect-ə yüklənən hər qurma ilə artmalıdır, hətta tətbiq versiyası dəyişməsə belə. Apple CFBundleVersion-dan qurmanın yeni və ya artıq yüklənmişin dublikatı olduğunu müəyyən etmək üçün istifadə edir. Qurma nömrəsi əvvəllər yüklənmiş ilə üst-üstə düşərsə, ITMS-90161 xətası verilir.

<key>CFBundleShortVersionString</key>
<string>1.2.0</string>
<key>CFBundleVersion</key>
<string>42</string>

Dəstəklənən interfeys oriyentasiyaları

UISupportedInterfaceOrientations açarları iPhone üçün dəstəklənən ekran oriyentasiyalarını müəyyən edir. iPad üçün cihaz suffiksi ilə ayrıca UISupportedInterfaceOrientations~ipad açarı istifadə olunur. Hər oriyentasiya sətirlə təyin edilir: UIInterfaceOrientationPortrait, UIInterfaceOrientationLandscapeLeft, UIInterfaceOrientationLandscapeRight, UIInterfaceOrientationPortraitUpsideDown. Tətbiq yalnız portret oriyentasiyasını dəstəkləyirsə, App Store qurmanı rədd edəcək, əgər o yalnız iPhone üçün deyilsə və iPad üçün yalnız portret göstərilibsə.

<key>UISupportedInterfaceOrientations</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
</array>

İcazələr və gizlilik açarları

iOS 10-dan başlayaraq, Apple hər tələb olunan icazənin təsvirini NS (NeXTStep) prefiksli açarlar vasitəsilə tələb edir. Təsvir özəl API-lərə ilk giriş sorğusunda istifadəçiyə sistem dialoqunda göstərilir. İcazə tələb edən API çağırarkən müvafiq NS açarının olmaması tətbiqin dərhal xəta ilə dayandırılmasına səbəb olur ki, bu da yalnız crash-loglarda qeydə alınır.

Hər gizlilik açarı sorğunun səbəbinin istifadəçi üçün başa düşülən təsvirini ehtiva etməlidir. Boş və ya şablon mətnlər, məsələn “Tətbiqin işləməsi üçün” və ya “Giriş tələb olunur”, App Store tərəfindən rədd edilməyə səbəb olur. Təsvir konkret funksionallığı izah etməlidir: “Kamera girişi QR kodlarını skan etmək və profil şəkilləri yaratmaq üçün lazımdır”. Hər dəstəklənən dil üçün InfoPlist.strings faylları vasitəsilə lokallaşdırılmış təsvir versiyalarından istifadə etmək tövsiyə olunur.

Özəl məlumatlara girişi olan API çağırarkən lazımi NS açarının olmaması tətbiqin çökməsinə səbəb olur. Sistem prosesi xəta ilə dayandırır ki, bu da yalnız Xcode və ya Firebase Crashlytics-dən crash hesabatlarının loqlarında görünür. İstifadəçi heç bir izahat olmadan yalnız tətbiqin qəfil bağlanmasını görür. Buna görə kameradan, mikrofondan və ya geolokasiyadan istifadə edən yeni funksionallıq əlavə etməzdən əvvəl əvvəlcə Info.plist-də müvafiq gizlilik açarını əlavə etməli, sonra API çağırışını tətbiq etməlisiniz.

Custom URL Schemes və App Links

CFBundleURLTypes açarı tətbiqdə dərin keçidlər üçün xüsusi URL sxemlərini qeydiyyatdan keçirir. Bu, tətbiqi brauzerdən, e-poçtdan və ya digər tətbiqlərdən tətbiqim://profil/123 kimi keçidlər vasitəsilə açmağa imkan verir. Hər sxem tətbiqi unikal şəkildə identifikasiya edir: iki tətbiq eyni sxemi qeydiyyatdan keçirərsə, sistem istifadəçiyə hansını istifadə edəcəyini seçmək üçün dialoq göstərir.

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.itsectr.myapp</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

Universal Links-i dəstəkləmək üçün Entitlements faylında com.apple.developer.associated-domains açarı tələb olunur, Info.plist-də deyil. Universal Links yalnız serverdə domeni tətbiqlə birləşdirən apple-app-site-association faylı konfiqurasiya edildikdə işləyir. Xüsusi URL sxemlərindən fərqli olaraq, Universal Links təsdiq dialoqu göstərmir və digər tətbiqlərlə ziddiyyət təşkil etmir, çünki xüsusi sxemlər deyil, HTTPS keçidləri istifadə olunur. Bununla belə, onlar etibarlı SSL sertifikatı olan domen tələb edir.

Xüsusi sxemlər iOS-un standart sxemləri ilə ziddiyyət təşkil edə bilər. Digər tətbiqlərlə toqquşmaları minimuma endirmək üçün ən azı 4 simvol uzunluğunda sxemlərdən istifadə etmək tövsiyə olunur. Məsələn, „fb” sxemi çox qısadır və ziddiyyət yarada bilər. Tərs qeyddən istifadə etmək daha yaxşıdır: tətbiqim:// əvəzinə tətbiq://. Həmçinin xatırlamaq lazımdır ki, tətbiq silinsə, lakin başqa tətbiq eyni sxemi qeydiyyatdan keçirərsə, istifadəçi keçidə daxil olarkən gözlənilməz davranışla qarşılaşa bilər.

İşə salma konfiqurasiyası və fon rejimləri

UIBackgroundModes açarı tətbiqin fon imkanlarını bəyan edir. Hər rejim Info.plist-də müvafiq təsvir və Xcode layihəsinin capabilities bölməsində təsdiq tələb edir. Rejim göstərilmədikdə, sistem fon tapşırığını 30 saniyədən sonra və ya resurs çatışmazlığında məcburi dayandıra bilər.

<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>remote-notification</string>
    <string>location</string>
    <string>processing</string>
</array>

UIApplicationSupportsMultipleScenes açarı iPad və Mac Catalyst-də çoxtapşırıqlılıq dəstəyini aktivləşdirir. Bu açar olmadan tətbiq çoxlu pəncərələri idarə etmək üçün SwiftUI ScenePhase və ya UIKit UISceneDelegate istifadə edə bilməz. iPadOS-da istifadəçilər bir tətbiqin çoxlu pəncərələrini aça, aralarında məzmun dartıya və Split View-dən istifadə edə bilər. Tətbiq çoxpəncərəli rejimi dəstəkləmirsə, bu açarı false olaraq təyin etmək müvafiq funksionallığı söndürür.

LSRequiresIPhoneOS açarı tətbiqin iPad-də quraşdırılmasını qadağan edir. iPad interfeysini dəstəkləməyən və ya böyük ekrana uyğunlaşdırılmamış yalnız iPhone üçün tətbiqlərdə istifadə olunur. Bununla belə, Apple bu açardan zərurət olmadan istifadə etməyi tövsiyə etmir, çünki istifadəçilər tətbiqlərin iOS və iPadOS ilə bütün cihazlarda işləyəcəyini gözləyirlər. Tətbiq yenə də iPhone ilə məhdudlaşırsa, bu tələbin texniki cəhətdən əsaslandırıldığına və App Store təsvirində göstərildiyinə əmin olun.

UIViewControllerBasedStatusBarAppearance açarı status zolağının üslubunu idarə edir. NO olaraq təyin edilərsə, status zolağının üslubu Info.plist-də UIStatusBarStyle açarı vasitəsilə qlobal olaraq təyin edilir. YES olarsa (iOS 7-dən etibarən defolt), hər ViewController preferredStatusBarStyle-i ləğv edərək öz status zolağını idarə edə bilər. Müasir tətbiqlər üçün YES buraxmaq tövsiyə olunur ki, müxtəlif ekranlarda fərqli status zolağı olsun, məsələn tünd fonda açıq və açıq fonda tünd.

UIApplicationExitsOnSuspend açarı tətbiqi fon rejiminə keçərkən dayandırmaq əvəzinə tamamilə bağlamağa məcbur edir. Yalnız yüksək təhlükəsizlik tələbləri olan tətbiqlər üçün nadir hallarda istifadə olunur: bank tətbiqləri və ya məxfi məlumatlarla işləyən tətbiqlər. Bu halda istifadəçi tətbiqə tez qayıtmaq imkanını itirir və hər işə salma təmiz vəziyyətdən baş verir. App Store baxış zamanı bu açardan istifadənin əsaslandırılmasını tələb edə bilər.

NSAppTransportSecurity açarı tətbiqin şəbəkə bağlantılarını idarə edir. iOS 9-dan başlayaraq, App Transport Security (ATS) HTTPS tələb edərək bütün HTTP bağlantılarını defolt olaraq bloklayır. Müəyyən domenlərə HTTP sorğularına müvəqqəti icazə vermək üçün NSAppTransportSecurity daxilində NSExceptionDomains lüğəti istifadə olunur. İnkişaf üçün ATS-ni NSAllowsArbitraryLoads = true vasitəsilə tamamilə söndürmək icazəlidir, lakin Apple əsaslandırma tələb edir və belə qurmaları ciddi səbəb olmadan buraxmır. İstehsal qurmasında ATS istifadəçi məlumatları ilə işləyən bütün domenlər üçün aktiv olmalıdır.