Встановлюючи targetSdkVersion = "xx", ви підтверджуєте, що ваш додаток працює належним чином (наприклад, ретельно і успішно перевірено) на рівні API xx.
Версія Android, що працює на рівні API вище xx, автоматично застосує код сумісності для підтримки будь-яких функцій, на які можна покластися, які були доступні на рівні xx або раніше, але які тепер застаріли на вищому рівні цієї версії Android.
І навпаки, якщо ви використовуєте будь-які функції, які застаріли на рівні xx або раніше , код сумісності не буде автоматично застосований версіями ОС на більш високих рівнях API (які більше не включають ці функції) для підтримки цих застосувань. У цій ситуації у вашому власному коді повинні бути спеціальні застереження, що перевіряють рівень API, і якщо виявлений рівень ОС є вищим, який більше не має заданої функції API, ваш код повинен використовувати альтернативні функції, які доступні у працюючих ОС Рівень API.
Якщо цього не зробити, то деякі функції інтерфейсу можуть просто не з’являтися, які зазвичай викликають події у вашому коді, і вам може бути відсутня важлива функція інтерфейсу, необхідна користувачеві для запуску цих подій та доступу до їх функціональності (як у приклад нижче).
Як зазначено в інших відповідях, ви можете встановити targetSdkVersion вище minSdkVersion, якщо ви хочете використати деякі функції API, спочатку визначені на більш високих рівнях API, ніж ваш minSdkVersion, і вжили заходів для того, щоб ваш код міг виявити та обробляти відсутність цих функцій на нижчі рівні, ніж targetSdkVersion.
Щоб попередити розробників спеціально перевірити мінімальний рівень API, необхідний для використання функції, компілятор видасть помилку (а не лише попередження), якщо код містить виклик до будь-якого методу, який був визначений на пізнішому рівні API, ніж minSdkVersion, навіть якщо targetSdkVersion перевищує або дорівнює рівню API, на якому цей метод вперше був доступний. Щоб усунути цю помилку, директива компілятора
@TargetApi(nn)
повідомляє компілятору, що код у межах цієї директиви (який передує або методу, або класу) був написаний для перевірки рівня API щонайменше nn до виклику будь-якого методу, який залежить від наявності принаймні цього рівня API . Наприклад, наступний код визначає метод, який можна викликати з коду в додатку, який має minSdkVersion менше 11 та targetSdkVersion 11 або вище:
@TargetApi(11)
public void refreshActionBarIfApi11OrHigher() {
//If the API is 11 or higher, set up the actionBar and display it
if(Build.VERSION.SDK_INT >= 11) {
//ActionBar only exists at API level 11 or higher
ActionBar actionBar = getActionBar();
//This should cause onPrepareOptionsMenu() to be called.
// In versions of the API prior to 11, this only occurred when the user pressed
// the dedicated menu button, but at level 11 and above, the action bar is
// typically displayed continuously and so you will need to call this
// each time the options on your menu change.
invalidateOptionsMenu();
//Show the bar
actionBar.show();
}
}
Ви також можете оголосити більш високий targetSdkVersion, якби ви протестували на цьому більш високому рівні і все працювало, навіть якщо ви не використовували жодних функцій з рівня API, вищого за ваш minSdkVersion. Це було б просто, щоб уникнути накладних витрат на доступ до коду сумісності, призначеного для адаптації від цільового рівня до мінімального рівня, оскільки ви б підтвердили (за допомогою тестування), що такої адаптації не потрібно.
Прикладом функції інтерфейсу користувача, яка залежить від оголошеного targetSdkVersion, може бути кнопка меню з трьома вертикальними точками, яка з’являється на панелі стану додатків, у яких targetSdkVersion менше 11, коли ці програми працюють під API 11 і вище. Якщо ваш додаток має targetSdkVersion 10 або нижче, передбачається, що інтерфейс вашого додатка залежить від існування спеціальної кнопки меню, і, отже, триточкова кнопка замість цього займає попередні спеціальні апаратні та / або екранні версії цієї кнопки (наприклад, як це видно в Gingerbread), коли в ОС вищий рівень API, для якого більше не передбачається спеціальна кнопка меню на пристрої. Однак якщо встановити targetSdkVersion програми 11 або вище, передбачається, що ви скористалися функціями, запровадженими на тому рівні, які замінюють спеціальну кнопку меню (наприклад, g., панель дій) або що ви іншим чином обійшли необхідність мати кнопку системного меню; отже, три вертикальне меню "кнопка сумісності" зникає. У такому випадку, якщо користувач не може знайти кнопку меню, вона не може натиснути її, а це, в свою чергу, означає, що перекриття функції onCreateOptionsMenu (меню) вашої діяльності ніколи не може бути викликано, що, знову ж таки, означає, що значна частина функцій вашого додатка може бути позбавлена його користувальницького інтерфейсу. Якщо, звичайно, ви не застосували панель дій або якийсь інший альтернативний спосіб для доступу користувача до цих функцій. не знайти кнопку меню, вона не може натиснути її, а це, в свою чергу, означає, що перезавантаження програми onCreateOptionsMenu (меню) може ніколи не викликатися, що, в свою чергу, означає, що значна частина функцій вашого додатка може бути позбавлений інтерфейсу користувача. Якщо, звичайно, ви не застосували панель дій або якийсь інший альтернативний спосіб для доступу користувача до цих функцій. не знайти кнопку меню, вона не може натиснути її, а це, в свою чергу, означає, що перезавантаження програми onCreateOptionsMenu (меню) може ніколи не викликатися, що, в свою чергу, означає, що значна частина функцій вашого додатка може бути позбавлений інтерфейсу користувача. Якщо, звичайно, ви не застосували панель дій або якийсь інший альтернативний спосіб для доступу користувача до цих функцій.
minSdkVersion, навпаки, заявляє вимогу, щоб версія ОС пристрою мала принаймні той рівень API, щоб запустити додаток. Це впливає на те, які пристрої можуть переглядати та завантажувати вашу програму, коли вона знаходиться у магазині додатків Google Play (а також, можливо, і в інших магазинах додатків). Це спосіб констатувати, що ваша програма покладається на ОС (API чи інші) функції, створені на цьому рівні, і не має прийнятного способу вирішити відсутність цих функцій.
Прикладом використання minSdkVersion для забезпечення наявності функції, що не пов’язана з API, було б встановити minSdkVersion на 8, щоб переконатися, що ваш додаток буде працювати лише у версії Dalvik-інтерпретатора з підтримкою JIT (з моменту введення JIT до перекладача Android на рівні 8). Оскільки продуктивність інтерпретатора, що підтримує JIT, може бути в п’ять разів більша за одну, у якої відсутня ця функція, якщо ваш додаток активно використовує процесор, то для забезпечення достатньої продуктивності вам може знадобитися API рівня 8 або вище.
