קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
תמונת מערכת גנרית (GSI) היא הטמעה של Android טהור עם קוד של פרויקט הקוד הפתוח של Android (AOSP) שלא עבר שינוי, שאפשר להריץ במגוון מכשירי Android.
מפתחי אפליקציות יכולים להתקין ולהפעיל את ה-GSI העדכני של Android כדי לבצע בדיקות של אפליקציות במגוון מכשירי Android קיימים, וגם להשתמש ב-GSI משלבי הפצה שונים של Android OS, כולל גרסאות Developer Preview וגרסאות בטא. הוספה של GSI לתהליכי האימות והבדיקה יכולה לספק לכם כמה יתרונות נוספים:
כיסוי רחב יותר של בדיקות במגוון גדול יותר של מכשירים אמיתיים
יותר זמן לפתרון בעיות בתאימות האפליקציה
יותר הזדמנויות לפתור בעיות תאימות ב-Android שמדווחות על ידי מפתחי אפליקציות
פרויקט ה-GSI הוא קוד פתוח ועוזר לשפר את הסביבה העסקית של Android על ידי מתן דרכים נוספות לשיפור האיכות של האפליקציות ומערכת ההפעלה לפני כל גרסה של Android.
איור 1: אפשר להתקין תמונות מערכת כלליות במגוון רחב של מכשירים, ולפעמים גם בגרסאות של Android שיצרן המכשיר לא מספק עבורן תמונת מערכת משלו.
קבצים מסוג GSI כוללים את אותן פונקציות ליבה של המערכת לכל המכשירים שבהם הם מותקנים. במילים אחרות, GSI לא כולל התאמות אישיות של יצרן המכשיר. לכן, יכול להיות שתיתקלו בהבדלים בהתנהגות במצבים הבאים:
אינטראקציות שכוללות את ממשק המשתמש
תהליכי עבודה שמבקשים תכונות חומרה חדשות יותר
בדיקת התאימות של המכשיר
מערכות GSI יכולות לפעול רק במכשירים עם המאפיינים הבאים:
תוכנת האתחול לא נעולה.
תאימות מלאה ל-Treble.
הושק עם Android 9 (API ברמה 28) ומעלה. יכול להיות שמכשירים ששודרגו ל-Android 9 מגרסה קודמת יתמכו ב-GSI ויכול להיות שלא.
כדי לקבוע אם אפשר להשתמש ב-GSI במכשיר שלכם ואיזו גרסת מערכת הפעלה של GSI צריך להתקין, פועלים לפי השלבים הבאים:
כדי לבדוק אם יש תמיכה ב-Treble, מריצים את הפקודה הבאה:
adb shell getprop ro.treble.enabled
אם התשובה היא false, המכשיר לא תואם ל-GSI ואין להמשיך. אם התשובה היא true, ממשיכים לשלב הבא.
כדי לבדוק אם יש תמיכה בין גרסאות, מריצים את הפקודה הבאה:
adb shell cat /system/etc/ld.config.version_identifier.txt \
| grep -A 20 "\[vendor\]"
בפלט, מחפשים בקטע [vendor] את
namespace.default.isolated.
אם הערך של המאפיין הזה הוא true, המכשיר תומך באופן מלא ב-Vendor Native Development Kit (VNDK) ויכול להשתמש בכל גרסה של מערכת הפעלה GSI שהיא חדשה יותר מגרסת מערכת ההפעלה במכשיר. כשהאפשרות זמינה, מומלץ להשתמש בגרסה העדכנית ביותר של מערכת ההפעלה GSI.
אם הערך של המאפיין הוא false, המכשיר לא תואם באופן מלא ל-VNDK, והמכשיר יכול להשתמש רק ב-GSI עבור אותה גרסת מערכת הפעלה במכשיר. לדוגמה, מכשיר עם Android 10 (גרסת API 29) שלא תואם ל-VNDK יכול לטעון רק תמונת GSI של Android 10.
סוג הארכיטקטורה של יחידת העיבוד המרכזית (CPU) של ה-GSI צריך להיות זהה לארכיטקטורה של יחידת העיבוד המרכזית של המכשיר. כדי למצוא את ארכיטקטורת ה-CPU המתאימה לתמונת ה-GSI, מריצים את הפקודה הבאה:
adb shell getprop ro.product.cpu.abi
משתמשים בפלט כדי לקבוע באיזו תמונת GSI להשתמש כשמבצעים פלאשינג למכשיר. לדוגמה, ב-Pixel 5, הפלט יציין שאדריכלות ה-CPU היא arm64-v8a, ולכן תשתמשו ב-GSI מסוג arm64.
הורדת תמונות מערכת כלליות (GSI)
יש כמה דרכים להשיג תמונות מערכת גנריות, בהתאם לצרכים שלכם בפיתוח:
כדי להוריד תמונות GSI של Android Preview ו-GSI של Android עם GMS, אפשר להיכנס לדף של גרסת ה-GSI.
כדי להוריד תמונות GSI מוכנות מראש ללא אפליקציות GMS, צריך להוריד את התמונות מהאתר AOSP CI:
כדי ליצור תמונות מערכת כלליות של Android בלי GMS, מורידים קוד מקור מ-AOSP ויוצרים את תמונות המערכת הכלליות.
התקנה של GSI
התקנת GSI תלויה במכשיר. כדי לדעת אילו כלים ופעולות בדיוק צריך, כדאי לעיין בהוראות של יצרן המכשיר. במכשירי Google Pixel, כמו Pixel 3 ומכשירים חדשים יותר, יש כמה דרכים להתקין את האפליקציה:
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-25 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-25 (שעון UTC)."],[],[],null,["# Generic System Images (GSIs)\n\nA Generic System Image ([GSI](https://source.android.com/setup/build/gsi)) is a\n*pure Android* implementation with unmodified Android Open Source Project (AOSP)\ncode, runnable on a variety of Android devices.\n\nApp developers can install and run the latest Android GSIs to perform app\ntesting on a variety of existing Android devices and using GSIs from different\nAndroid OS release stages, including Developer Preview and Beta builds. Adding\nGSIs to your verification and testing processes can provide you with some extra\nbenefits:\n\n- Broader test coverage on a greater set of real devices\n- More time to fix app compatibility issues\n- More opportunities to fix compatibility issues in Android that are reported by app developers\n\nThe GSI project is [open\nsource](https://android.googlesource.com/platform/manifest/+/refs/heads/pie-gsi#)\nand helps improve the Android ecosystem by providing more ways to improve app\nand OS quality before each release of Android.\n**Figure 1**: GSIs can be installed across a broad range of devices, and sometimes even for versions of Android that a device manufacturer doesn't provide their own system image for.\n\nGSIs include the same core system functionalities for all devices that they're\ninstalled on. In other words, a GSI does not include device manufacturer's\ncustomizations. Because of this, you might encounter behavioral differences in\nthe following situations:\n\n- Interactions that involve the UI\n- Workflows that request newer hardware features\n\nCheck device compliance\n-----------------------\n\nGSIs can only function on devices with the following characteristics:\n\n- Bootloader is unlocked.\n- Fully Treble-compliant.\n- Launched with Android 9 (API level 28) or higher. Devices upgraded to Android 9 from an earlier version might or might not support GSIs.\n\n| **Warning:** Attempting to flash a GSI to a non-compliant device could result in your device becoming non-bootable. Always confirm that your device is compliant before flashing, and follow the installation steps provided by your device's manufacturer. GSIs don't support rollback, so you will need a recovery method and original system ROM to revert to the original system.\n\nTo determine whether your device can use a GSI and which GSI OS version you\nshould install, do the following:\n\n1. Check for Treble support by running the following command:\n\n ```\n adb shell getprop ro.treble.enabled\n ```\n\n If the response is `false`, the device isn't compatible with GSIs and you\n shouldn't continue. If the response is `true`, continue to the next step.\n2. Check for cross-version support by running the following command:\n\n ```\n adb shell cat /system/etc/ld.config.version_identifier.txt \\\n | grep -A 20 \"\\[vendor\\]\"\n ```\n | **Note:** Depending on your platform, the configuration file in the preceding command may or may not have a version identifier in it.\n\n In the output, look in the `[vendor]` section for\n `namespace.default.isolated`.\n\n If the value for that attribute is `true`, then the device fully supports\n [Vendor Native Development Kit\n (VNDK)](https://source.android.com/devices/architecture/vndk) and can use\n any GSI operating system (OS) version that is newer than the on-device OS\n version. Whenever possible, use the latest GSI OS version that is available.\n\n If the value for the attribute is `false`, then the device isn't fully\n VNDK-compliant, and the device can use only a GSI for the same on-device OS\n version. For example, an Android 10 (API version 29) device that isn't\n VNDK-compliant can load only an Android 10 GSI image.\n3. The GSI CPU architecture type must match the device's CPU architecture. To\n find the right CPU architecture for the GSI image, run the following\n command:\n\n ```\n adb shell getprop ro.product.cpu.abi\n ```\n\n Use the output to determine which GSI image to use when flashing your\n device. For example, on a Pixel 5, the output would indicate that the CPU\n architecture is `arm64-v8a`, so you would use the `arm64` type of GSI.\n\nDownload GSIs\n-------------\n\nThere are a few ways to get GSIs, depending on your development needs:\n\n- For Android Preview GSIs and Android GSIs with GMS, download the images from the [GSI release page](/topic/generic-system-image/releases).\n- For pre-built GSI images without GMS applications, download the images from\n the AOSP CI site:\n\n - [Android 10 (API level\n 29)](https://ci.android.com/builds/branches/aosp-android10-gsi/grid?)\n - [Android 11 (API level\n 30)](https://ci.android.com/builds/branches/aosp-android11-gsi/grid?)\n - [Android 12 (API level\n 31)](https://ci.android.com/builds/branches/aosp-android12-gsi/grid?)\n - [Android 13 (API level\n 33)](https://ci.android.com/builds/branches/aosp-android13-gsi/grid?)\n- To build Android GSIs without GMS, download source code from\n [AOSP](https://source.android.com/setup/build/gsi#building-gsis) and build\n your GSIs.\n\n| **Important:** Device manufacturers shouldn't use these versions of GSIs to run and submit compliance tests. Instead, device manufacturers should continue to refer to their existing communication channels, such as their Technical Account Managers for compliance-test-related activities.\n\nInstall a GSI\n-------------\n\n| **Note:** If your device has adopted [Android Verified\n| Boot](https://source.android.com/security/verifiedboot/avb) (AVB), download and flash the following image to disable AVB before flashing a GSI: [vbmeta.img](https://dl.google.com/developers/android/qt/images/gsi/vbmeta.img)\n\nInstalling a GSI is device-dependent. Refer to your device's manufacturer for\nthe exact tools and procedures. For Google Pixel devices such as the Pixel 3 and\nnewer, there are several ways to install:\n\n- Manually flashing GSI images: see [Requirements for flashing GSIs](https://source.android.com/setup/build/gsi#flashing-gsis)\n- Using Dynamic System Update (DSU) for devices that already run Android 10 or higher: see the [Dynamic System Updates](/topic/dsu) page\n\nGive feedback\n-------------\n\nGSIs are intended to help you validate your apps on Android. We appreciate your\nfeedback on the images, the tools, and the process for using GSIs on your\ndevices.\n\nTo notify us of bugs or feature requests, use the [dedicated issue tracker\ncomponent](https://issuetracker.google.com/issues/new?component=470386&template=1147338)\nfor GSIs.\n\nAdditional resources\n--------------------\n\n- [Understand the impact of Generic System Images (GSI) (Android Dev Summit\n '18)](https://www.youtube.com/watch?v=Y-HmCIHD63w)"]]
