במסמך הזה מוסבר איך להתחיל להשתמש בספריית הגרפיקה של Vulkan על ידי הורדה, הידור והפעלה של אפליקציה לדוגמה של Khronos©.
דרישות מוקדמות
לפני שמתחילים, חשוב לוודא שיש לכם את גרסת החומרה והפלטפורמה המתאימה. צריך להשתמש במכשיר או באמולטור שתומך ב-Vulkan, עם Android מגרסה 7.0 (Nougat), API ברמה 24 ואילך.
כדי לבדוק איזו גרסת Android מותקנת במכשיר, עוברים לתפריט הגדרות. ובחירה באפשרות מידע על הטלפון > גרסת Android. אחרי שתוודאו אם הגדרתם את גרסת החומרה והפלטפורמה המתאימה, תוכלו להוריד את התוכנה המתאימה.
הורדה
לפני שמתחילים, צריך להוריד כמה כלים ותוכנות אחרות. שימו לב שבמארח של Windows, מומלץ להימנע מהיררכיית נתיבים עמוקה של קבצים עבור כלים וקוד מקור. היא נועדה לעקוף מגבלות נתיב קבצים בחלק מהגרסאות של Windows OS.
- אם עוד לא הורדתם את אפליקציית Android Studio, מורידים אותה. הגרסה הזו כוללת את Android SDK העדכני ביותר.
- התקנת NDK ו-CMake מתוך Android Studio או להוריד ולהתקין אותם בנפרד.
- יצירה והפעלה של דוגמת JNI של Hello כדי לוודא ש-Android Studio פועל כמו שצריך.
- התקנת python3 ורכיבים אחרים שמופיעים ב-build.md לפלטפורמת המארח שלכם.
ייבוא
בקטע הזה, מורידים את מאגר הדגימות של Khronos© Vulkan©, ויוצרים שדרוג ל-Android. בפרויקט הרלוונטי, ופותחים אותו בסביבת הפיתוח המשולבת Android Studio IDE.
- מגדירים את משתני הסביבה הבאים:
export ANDROID_HOME=/path/to/sdk-directory export ANDROID_NDK_HOME=$ANDROID_HOME/ndk/{your-ndk-version-dir}
- מוסיפים את CMake ל $PATH, שמשמש ליצירת סקריפטים של build ל-Android:
export PATH=$PATH:$ANDROID_HOME/cmake/{your-cmake-version}/bin
- פותחים טרמינל ומורידים את קוד המקור לספריית הפיתוח:
cd dev-directory git clone --recursive https://github.com/KhronosGroup/Vulkan-Samples.git
- יש לבצע את ההוראות הבאות (באתר Build.md)
כדי ליצור את הפרויקט לדוגמה של Android:
cd Vulkan-Samples ./scripts/generate.py android
- פותחים את Android Studio. בוחרים באפשרות File > (קובץ >) פתיחה ובחירה
Vulkan-Samples/build/android_gradle/build.gradle
. אחרי הטעינה של Android Studio אתם אמורים לראות משהו דומה לזה הפרויקט:איור 1. הפרויקט לדוגמה ב-Android Studio.
הידור
כל הדוגמאות במאגר הזה מאורגנות בפרויקט Android אחד. כדי להדר מבצעים אחת מהפעולות הבאות:
- כדי להדר את המקורות בלבד, משתמשים בתפריט יצירה > יצירת פרויקט, או מקישים על מקש הקיצור Ctrl-F9.
- כדי ליצור את קובץ ה-APK לדוגמה, בוחרים בתפריט Build > יצירת חבילות/חבילות APK > יצירת חבילות APK.
ההודעה על ה-build אמורה להופיע בחלון Build של Android Studio. אם מופיעות שגיאות, צריך לתקן אותן ולהידור מחדש.
![המערכת אוספת פרויקט לדוגמה באמצעות Studio.](https://developer.android.com/ndk/guides/images/vk-guide-compile-project.png?authuser=0&hl=he)
ביצוע
לפני הרצת הפרויקט לדוגמה, עליך לוודא ש-Android Studio מזהה את מכשיר Vulkan או אמולטור Android מחובר. אתם אמורים לראות משהו כמו הבאים:
![מתבצע חיבור של מכשיר הבדיקה ל-Studio.](https://developer.android.com/ndk/guides/images/vk-guide-test-device.png?authuser=0&hl=he)
כדי להפעיל את הפרויקט:
- השתמש בתפריט הפעלה > מריצים את vulkan_sample או לוחצים על לחצן ההרצה
בסרגל הכלים, ולהמתין ל- הדוגמה שצריך להתקין כדי להתקין ולהפעיל במכשיר המחובר.
- במכשיר Android המחובר, מאשרים את בקשות הגישה הנדרשות.
- מפעילים את האפשרות הענקת גישה כדי לנהל את כל הקבצים, ואז מקישים על החץ לחצן 'הקודם'. כדי להחזיר את מסך ההתחלה הראשי לדוגמה.
- מאפשרים גישה לדיסק:
איור 4. מפעילים גישה לדיסק.
- אתם אמורים לראות את מסך התפריט הראשי לדוגמה, באופן הבא:
איור 5. תפריט ראשי לדוגמה. - מעיינים ברשימת הדוגמאות ובוחרים כמה דוגמאות להרצה.
אם זו הפעם הראשונה שאתם מפתחים את Vulkan, תוכלו להתחיל עם דוגמאות 'API'.
לדוגמה, הקשה על 'משולש שלום' אמורה להציג משולש מעובד
דומה לנוסחה:
איור 6. שלום לדוגמה של Triange.
מערכת הפיתוח שלך מוגדרת עכשיו להרצת דוגמאות במכשיר הבדיקה.
דגימות Vulkan פותחו עבור מערכות הפעלה מרובות, כולל מערכות ההפעלה במחשבים שולחניים ובניידים. חלק מהדוגמאות בקטעים ביצועים, תוספים כלי עזר עלול להיות לא יציב ולקרוס במכשיר. יכולות להיות לכך כמה סיבות, כ:
- התכונות הספציפיות של Vulkan לא תוכננו ל-Android.
- אין תמיכה בגרסת Android OS במכשיר.
- יכולת ה-GPU של פלטפורמת החומרה.
אפשרויות נוספות
הקטע Java בדוגמת Vulkan נגזר מהמחלקה NativeActivity. הוא עובר אפליקציה רגילה אירועים במחזור החיים, כמו יצירה, הפעלה, עצירה והשמדה של אפליקציה ל-C/C++ בקטע C/C++ שבדגימה, יש framework לדוגמה. שמטמיעה את פונקציונליות ההחלפה של דגימות משנה של זמן ריצה. במידה רבה ככלל, אירועים/הודעות במערכת Android עוברים את הנתיב הבא אל להגיע לקוד ה-Vulkan של האפליקציה לדוגמה:
NativeSampleActivity
קטע של JavaNativeSampleActivity
קטע C/C++- קוד אחד (
android_native_glue
) android_main
- מסגרת לדוגמה
- קוד של תת-דוגמה בודדת
android_main
הוא הגבול בין NativeSampleActivity
לקוד האפליקציה,
זו יכולה להיות נקודת ההתחלה שבה תרצו לעקוב אחרי הקוד לדוגמה. אם רק
שרוצים להתמקד במקורות הספציפיים של Vulkan, אפשר לחקור את הקוד
Vulkan_Samples\samples
, שכולל את הפרטים הבאים:
- דוגמאות של קטגוריית 'api'.
- דוגמאות לקטגוריות 'ביצועים'.
- דוגמאות של קטגוריות 'תוספים'.
- דוגמאות של 'כלים'.
מכשירי Vulkan_Samples\shaders
הם הבית לכל תוכנות ההצללה.
תוכלו להתחיל לעיין בדוגמאות של קטגוריות API כדי להכיר את שימוש ב-Vulkan וה-framework לדוגמה. לאחר מכן תוכלו להתקדם דוגמאות לקטגוריות 'ביצועים' ו'תוספים'. לקוד של תוכנת ההצללה, אפשר להשתמש בתצוגה פרויקט ב-Android Studio.
![תוכנת ההצללה (shader) של משולש.](https://developer.android.com/ndk/guides/images/vk-guide-shaders.png?authuser=0&hl=he)
מקורות מידע נוספים
Vulkan API עבר כמה גרסאות, אז הוא בשלבי בוגר. הוולקן הוועדה הרגילה וקהילת Vulkan יצרו אוסף עשיר של Vulkan שמדגים את השימוש ב-API ואת השיטות המומלצות. הבאים מכילה כמה משאבים לפיתוח אפליקציות של Vulkan:
מפרט Vulkan. קבוצת חררון שומרת על המפרט של Vulkan. צפייה בדף הבית של Vulkan תמצאו את המפרט המלא, הדרכה, מדריכים ו-מדריכים.
שכבות אימות. שכבות האימות חיוניות לפיתוח אפליקציות. מידע נוסף על שכבות האימות של Vulkan ב-Android לקבלת פרטים נוספים.
Shaderc. קוד Shaderc ב-NDK הוא במורד הזרם מאגר Shaderc למסמכי השימוש והוראות לקבלת הגרסה העדכנית ביותר, מהדררים של Shader.