מדריך למתחילים ל-Android

הגדרת סביבת הפיתוח

פתיחת הפרויקט לדוגמה

מציאת הפרויקטים לדוגמה. תוכלו לבחור באחת מהאפשרויות הבאות:

  • הורדה וחילוץ של דוגמאות הדגימה

    -או-

  • שכפול המאגר עם הפקודה הבאה:

    git clone https://github.com/google-ar/sceneform-android-sdk.git

ב-Android Studio, פותחים את פרויקט הדוגמה שלום ספוט, שנמצא בספריית המשנה אפליקציה בספריית sceneform-android-sdk.

הכנת המכשיר או האמולטור

ניתן להפעיל אפליקציות AR במכשיר נתמך או באמולטור Android:

יש דרישות נוספות להפעלה של אפליקציות הדמיה באמולטור:

  • יש צורך בגרסה אמולטור Android בגרסה 27.2.9 ואילך.

  • התמיכה ב-OpenGL ES 3.0 ובגרסאות מתקדמות יותר מופעלת באמולטור Android.

    • צריך לוודא שאמולטור שלך משתמש בגרסה האחרונה. בחלונית הבקרה המורחבת (עוד בסרגל הכלים), בוחרים באפשרות הגדרות > Advanced > Open ES API > לרינדור מקסימלי (עד OpenGL ES 3.1), ואז מפעילים את האמולטור מחדש.

    • מריצים את האמולטור, מקיימים אינטראקציה קצרה עם האמולציה של המכשיר ואז בודקים אם נעשה שימוש ב-OpenGL ES 3.0 ואילך:

      adb logcat | grep eglMakeCurrent

      אם מוצגת לך גרסה ver 3 0 או גרסה מתקדמת יותר, באפשרותך להריץ אפליקציות Skyform. אם אתם רואים גרסה נמוכה יותר, סימן ה-GPU במחשב הנייח שלכם לא תומך ב-OpenGL ES 3.0. כדי להריץ אפליקציות של schemaform עליכם להשתמש במכשיר נתמך.

הרצת הדגימה

מוודאים שמכשיר ה-Android מחובר למכונת הפיתוח ולוחצים על הפעלה ב-Android Studio. לאחר מכן, בחרו את המכשיר בתור יעד הפריסה ולחצו על אישור.

מערכת Android Studio בונה את הפרויקט ל-APK ניפוי באגים, מתקינה את ה-APK ואז מפעילה את האפליקציה במכשיר. מידע נוסף זמין במאמר יצירה והפעלה של האפליקציה.

יכול להיות שתתבקשו להתקין או לעדכן את Google Play Services ל-AR אם הוא חסר או לא עדכני. בחרו באפשרות המשך כדי להתקין את האפליקציה מחנות Google Play.

האפליקציה שלום ספוט מאפשרת לכם להציב פסלונים של Android ולטפל בהם במשטחים שטוחים.

הוספת סביבת פרויקט לפרויקט קיים

כדי להשתמש ב-Squareform בפרויקט קיים:

  1. פועלים לפי השלבים להפעלת ARCore באפליקציה

  2. מוסיפים את ספריית schemaform לקובץ app'sbuild.gradle:

    android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.15.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.15.0'
}

השלבים הבאים