[آموزشی] - API

[P O U R I A]

سطح API چیست؟


سطح API یک مقدار عدد صحیح است که منحصرا اصلاح framework API را که توسط یک ورژن از پلتفرم اندروید ارائه شده است، شناسایی می کند.

پلتفرم اندروید یک framework API را فراهم می کند که برنامه ها می توانند با استفاده از آن با سیستم زیرین اندروید ارتباط برقرار کنند. framework API شامل:

• یک مجموعه اصلی از بسته ها و کلاس ها
• یک مجموعه از المان های XML و خواص برای اعلام یک فایل فهرست
• یک مجموعه از المان های XML و خواص برای اعلام و دسترسی به منابع
• یک مجموعه از مفاهیم
• یک مجموعه از دسترسی ها که هر برنامه می تواند درخواست کند، و نیز دسترسی های اجرایی که در سیستم موجود می باشند.

هر ورژن متوالی از پلتفرم اندروید می تواند شامل آپدیت هایی برای framework API برنامه های اندرویدی باشد که ارائه می کند.
اپدیت ها برای framework API طراحی شده اند که API جدید با API قبلی سازگار بماند. به همین دلیل بیشتر تغییرات در API افزودنی و معرفی یک قابلیت و عملکرد جدید است. در حالی که قسمت های از API ارتقا می یابد، قسمت های قدیمی جایگزین شده حذف نمی شوند تا برنامه های کنونی قادر به استفاده از آن ها باشند. در موارد بسیار اندکی این احتمال وجود دارد که قسمتی از یک API اصلاح یا حذف شود، اگرچه معمولا چنین تغییراتی فقط برای حاصل شدن اطمینان از نیرومندی API و امنیت برنامه و سیستم نیاز است. سایر قسمت های ورژن های قدیمی تر API در ارتقا به ورژن های جدید حفظ می شوند.

 

[P O U R I A]

framework API که با پلتفرم اندروید ارائه می شود، توسط یک عدد صحیح مشخصه به نام "سطح API" یا "API Level" مشخص می شوند. هر ورژن پلتفرم اندروید دقیقا یک سطح API را پشتیبانی می کند، اگرچه پشتیبانی از API های قدیمی همچنان حفظ می شود. نسخه اولیه پلتفرم اندروید سطح API 1 را فراهم کرد.

ورژن اندروید	درجه API	نام ورژن
اندروید 4.1, 4.1.1	16	JELLY_BEAN
اندروید 4.0.3, 4.0.4	15	ICE_CREAM_SANDWICH_MR1
اندروید 4.0, 4.0.1, 4.0.2	14	ICE_CREAM_SANDWICH
اندروید 3.2	13	HONEYCOMB_MR2
اندروید 3.1	12	HONEYCOMB_MR1
اندروید 3.0	11	HONEYCOMB
اندروید 2.3.4 اندروید 2.3.3	10	GINGERBREAD_MR1
اندروید 2.3.2 اندروید 2.3.1 اندروید 2.3	9	GINGERBREAD
اندروید 2.2	8	FROYO
اندروید 2.1	7	ECLAIR_MR1
اندروید 2.0.1	6	ECLAIR_0_1
اندروید 2.0	5	ECLAIR
اندروید 1.6	4	DONUT
اندروید 1.5	3	CUPCAKE
اندروید 1.1	2	BASE_1_1
اندروید 1.0	1	BASE

 

[P O U R I A]

استفاده از سطح API در اندروید


تشخیص دهنده سطح API نقش کلیدی را در مطمئن شدن از حصول بهترین تجربه ممکن برای کاربران و توسعه دهندگان نرم افزاری بازی می کند:

• اجازه می دهد که پلتفرم اندروید حداکثر اصلاح framework API را که پشتیبانی می کند تشریح کند.
• اجازه می دهد که برنامه ها اصلاح framework API را که نیاز دارند، تشریح کنند.
• اجازه می دهد که سیستم نصب برنامه ها را روی دستگاه کاربر بررسی کند.

هر ورژن پلتفرم اندروید تشخیص دهنده سطح API خود را درون خود نگه داری می کند، درون سیستم اندروید.
برنامه ها می توانند از یک المان فهرستی که توسط framework API فراهم شده است، برای تشریح حداقل و حداکثر سطح API که می توانند تحت آن اجرا شوند، استفاده کنند. همچنین سطح API که برای پشتیبانی از آن طراحی شده اند را نیز اعلام می کنند. المان 3 خواص کلیدی را پیشنهاد می کند:

• android:minSdk version : حداقل سطح API را مشخص می کند.
• android:targetSdkVersion : سطح API که برنامه برای اجرا روی آن طراحی شده است را مشخص می کند.
• android:maxSdkVersion : حداکثر سطح API را مشخص می کند.

برای مثال، برای تعیین حداقل API لازم برای اجرای برنامه، برنامه درون فهرست خود یک المان <user-sdk> با یک خاصیت android:minSdkVersion را دارا می باشد. مقدار android:minSdkVersion یک عدد صحیح است که حداقل سطح API را که برنامه تحت ان اجرا می شود، معرفی می کند.
زمانی که کاربر قصد نصب یک برنامه را می کند یا معتبر سازی برنامه بعد از آپدیت سیستم انجام می شود، سیستم اندروید ابتدا خواص <user-sdk>را در فهرست برنامه چک می کند. سیستم فقط زمانی اجازه نصب برنامه را می دهد که شرایط زیر برقرار باشد:

• اگر حداقل سطح API اعلام شده باشد و مقدار آن باید کمتر یا برابر مقدار سطح API داخلی سیستم باشد.
• اگر حداکثر سطح API اعلام شده باشد و مقدار آن باید برابر یا بیشتر از مقدار سطح API داخلی سیستم باشد.

زمانی که در فهرست برنامه اعلام می شود، یک المان <user-sdk>ممکن است شبیه زیر باشد:

<manifest>
<uses-sdkandroid:minSdkVersion="5" />
 ...
</manifest>

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