فیلترها در گوگل پلی

یک برنامه با تنظیم ویژگی‌های عنصر <supports-screens> اندازه‌های صفحه‌ای را که می‌تواند پشتیبانی کند، نشان می‌دهد. هنگامی که برنامه منتشر می شود، Google Play از این ویژگی ها برای تعیین اینکه آیا برنامه را به کاربران بر اساس اندازه صفحه نمایش دستگاه هایشان نشان می دهد یا خیر، استفاده می کند.

به عنوان یک قاعده کلی، Google Play فرض می‌کند که پلتفرم روی دستگاه می‌تواند طرح‌بندی‌های کوچک‌تر را با صفحه‌های بزرگ‌تر تطبیق دهد، اما نمی‌تواند طرح‌بندی‌های بزرگ‌تر را با صفحه‌های کوچک‌تر تطبیق دهد. بنابراین، اگر برنامه ای فقط از اندازه صفحه نمایش "عادی" پشتیبانی کند، Google Play برنامه را برای دستگاه های معمولی و بزرگ در دسترس قرار می دهد، اما برنامه را فیلتر می کند تا برای دستگاه های صفحه کوچک در دسترس نباشد.

اگر یک برنامه ویژگی‌ها را برای <supports-screens> اعلام نکند، Google Play از مقادیر پیش‌فرض برای آن ویژگی‌ها استفاده می‌کند که بر اساس سطح API متفاوت است. به طور مشخص:

• برای برنامه‌هایی که android: minSdkVersion یا android: targetSdkVersion روی 3 یا پایین‌تر تنظیم می‌کنند، خود عنصر <supports-screens> تعریف نشده است و هیچ ویژگی در دسترس نیست. در این حالت، Google Play فرض می‌کند که برنامه برای صفحه‌نمایش‌هایی با اندازه معمولی طراحی شده است و برنامه را به دستگاه‌هایی که صفحه‌نمایش معمولی یا بزرگ‌تر دارند نشان می‌دهد.

• وقتی android: minSdkVersion یا android: targetSdkVersion روی 4 یا بالاتر تنظیم شود، پیش‌فرض برای همه ویژگی‌ها "true" است. به این ترتیب اپلیکیشن به صورت پیش فرض از تمامی اندازه های صفحه نمایش پشتیبانی می کند.

مثال 1
مانیفست <uses-sdk android:minSdkVersion="3"> را اعلام می کند و عنصر <supports-screens> را شامل نمی شود. نتیجه : Google Play برنامه را به کاربر دستگاهی با صفحه‌نمایش کوچک نشان نمی‌دهد، اما آن را به کاربران دستگاه‌های معمولی و صفحه‌نمایش بزرگ نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

مثال 2
مانیفست <uses-sdk android:minSdkVersion="3" android:targetSdkVersion="4"> را اعلام می کند و عنصر <supports-screens> را شامل نمی شود. نتیجه : Google Play برنامه را در همه دستگاه‌ها به کاربران نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

مثال 3
مانیفست <uses-sdk android:minSdkVersion="4"> را اعلام می کند و عنصر <supports-screens> را شامل نمی شود. نتیجه : Google Play برنامه را به همه کاربران نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

برای اطلاعات بیشتر در مورد نحوه اعلام پشتیبانی از اندازه صفحه در برنامه خود، به <supports-screens> و Supporting Multiple Screens مراجعه کنید.

یک برنامه می‌تواند ویژگی‌های سخت‌افزاری خاصی را درخواست کند، و Google Play برنامه را فقط در دستگاه‌هایی نشان می‌دهد که سخت‌افزار مورد نیاز را دارند.

مثال 1
مانیفست شامل <uses-configuration android:reqFiveWayNav="true" /> است و کاربر در حال جستجوی برنامه ها در دستگاهی است که کنترل ناوبری پنج طرفه ندارد. نتیجه : Google Play برنامه را به کاربر نشان نمی‌دهد.

مثال 2
مانیفست شامل عنصر <uses-configuration> نیست. نتیجه : Google Play برنامه را به همه کاربران نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

برای جزئیات بیشتر، <uses-configuration> ببینید.

یک برنامه می‌تواند به وجود ویژگی‌های دستگاه خاصی در دستگاه نیاز داشته باشد. این قابلیت در اندروید 2.0 (سطح 5 API) معرفی شد.

مثال 1
مانیفست شامل <uses-feature android:name="android.hardware.sensor.light" /> است و کاربر در حال جستجوی برنامه‌ها در دستگاهی است که سنسور نور ندارد. نتیجه : Google Play برنامه را به کاربر نشان نمی‌دهد.

مثال 2
مانیفست شامل عنصر <uses-feature> نیست. نتیجه : Google Play برنامه را به همه کاربران نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

برای اطلاعات کامل، به <uses-feature> مراجعه کنید.

فیلتر کردن بر اساس ویژگی‌های ضمنی: در برخی موارد، Google Play مجوزهای درخواست شده از طریق عناصر <uses-permission> را به‌عنوان الزامات ویژگی معادل موارد اعلام شده در عناصر <uses-feature> تفسیر می‌کند. به <uses-permission> ، در زیر مراجعه کنید.

یک برنامه ممکن است نیاز داشته باشد که دستگاه از یک نسخه OpenGL-ES خاص با استفاده از ویژگی <uses-feature android:openGlEsVersion="int"> پشتیبانی کند.

مثال 1
یک برنامه چندین نسخه OpenGL-ES را با تعیین openGlEsVersion چندین بار در مانیفست درخواست می کند. نتیجه : Google Play فرض می‌کند که برنامه به بالاترین نسخه از نسخه‌های نشان‌داده‌شده نیاز دارد.

مثال 2
یک برنامه OpenGL-ES نسخه 1.1 را درخواست می کند و کاربر در حال جستجوی برنامه ها در دستگاهی است که از OpenGL-ES نسخه 2.0 پشتیبانی می کند. نتیجه : Google Play برنامه را به کاربر نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند. اگر دستگاهی گزارش دهد که از OpenGL-ES نسخه X پشتیبانی می‌کند، Google Play فرض می‌کند که از هر نسخه زودتر از X نیز پشتیبانی می‌کند.

مثال 3
کاربر در حال جستجوی برنامه‌ها در دستگاهی است که نسخه OpenGL-ES را گزارش نمی‌کند (به عنوان مثال، دستگاهی که Android نسخه 1.5 یا بالاتر دارد). نتیجه : Google Play فرض می‌کند که دستگاه فقط OpenGL-ES 1.0 را پشتیبانی می‌کند. Google Play فقط برنامه‌های کاربری را نشان می‌دهد که openGlEsVersion یا برنامه‌هایی را که نسخه OpenGL-ES بالاتر از 1.0 را مشخص نمی‌کنند، نشان می‌دهد.

مثال 4
مانیفست openGlEsVersion مشخص نمی کند. نتیجه : Google Play برنامه را به همه کاربران نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

برای جزئیات بیشتر، <uses-feature> را ببینید.

یک برنامه می‌تواند به کتابخانه‌های مشترک خاصی نیاز داشته باشد که در دستگاه وجود داشته باشد.

مثال 1
یک برنامه به کتابخانه com.google.android.maps نیاز دارد و کاربر در دستگاهی که کتابخانه com.google.android.maps را ندارد به دنبال برنامه ها می گردد. نتیجه : Google Play برنامه را به کاربر نشان نمی‌دهد.

مثال 2
مانیفست شامل عنصر <uses-library> نیست. نتیجه : Google Play برنامه را به همه کاربران نشان می‌دهد، مگر اینکه فیلترهای دیگری اعمال شوند.

برای جزئیات بیشتر، به <uses-library> مراجعه کنید.

اکیداً، Google Play بر اساس عناصر <uses-permission> فیلتر نمی‌کند. با این حال، المان‌ها را می‌خواند تا مشخص کند که آیا برنامه دارای الزامات ویژگی سخت‌افزاری است که ممکن است به درستی در عناصر <uses-feature> اعلان نشده باشد. به عنوان مثال، اگر برنامه‌ای مجوز CAMERA درخواست کند اما عنصر <uses-feature> را برای android.hardware.camera اعلام نکند، Google Play در نظر می‌گیرد که برنامه به دوربین نیاز دارد و نباید به کاربرانی که دستگاه‌هایشان یک دوربین ارائه نمی‌دهند نشان داده شود. دوربین

به طور کلی، اگر برنامه‌ای مجوزهای مربوط به سخت‌افزار را درخواست کند، Google Play فرض می‌کند که برنامه به ویژگی‌های سخت‌افزار اساسی نیاز دارد، حتی اگر هیچ متناظری با اعلان‌های <uses-feature> وجود نداشته باشد. سپس Google Play فیلتر را بر اساس ویژگی‌هایی که در اعلان‌های <uses-feature> ذکر شده است تنظیم می‌کند.

برای فهرستی از مجوزهایی که دلالت بر ویژگی های سخت افزاری دارند، به مستندات عنصر <uses-feature> مراجعه کنید.

یک برنامه ممکن است به حداقل سطح API نیاز داشته باشد.

مثال 1
مانیفست شامل <uses-sdk android:minSdkVersion="3"> است، و برنامه از API هایی استفاده می کند که در سطح 3 API معرفی شده اند. کاربر در حال جستجوی برنامه ها در دستگاهی است که دارای API سطح 2 است. نتیجه : Google Play نمی کند برنامه را به کاربر نشان دهید.

مثال 2
مانیفست شامل minSdkVersion نیست و برنامه از APIهایی استفاده می‌کند که در سطح 3 API معرفی شده‌اند. کاربر در حال جستجوی برنامه‌ها در دستگاهی است که دارای API سطح 2 است. نتیجه : Google Play فرض می‌کند که minSdkVersion "1" است و این برنامه با تمامی نسخه های اندروید سازگار است. گوگل پلی برنامه را به کاربر نشان می دهد و به کاربر اجازه می دهد برنامه را دانلود کند. برنامه در زمان اجرا از کار می افتد.

از آنجایی که می‌خواهید از این سناریوی دوم اجتناب کنید، توصیه می‌کنیم همیشه یک minSdkVersion را اعلام کنید. برای جزئیات، android:minSdkVersion ببینید.

منسوخ شده است. Android نسخه 2.1 و بالاتر، ویژگی maxSdkVersion را بررسی یا اجرا نکنید، و اگر maxSdkVersion در مانیفست برنامه تنظیم شده باشد، SDK کامپایل نخواهد شد. برای دستگاه‌هایی که قبلاً با maxSdkVersion کامپایل شده‌اند، Google Play به آن احترام گذاشته و از آن برای فیلتر کردن استفاده می‌کند.

اعلام maxSdkVersion توصیه نمی شود. برای جزئیات، android:maxSdkVersion ببینید.