מדריך | יצירת הרחבות

[mefateach]

שימו-️ המדריך משולב עם כמה מדריכים נוספים בפורום

לבניית הרחבות נצטרך:

1. jdk גרסה 8 מדריך התקנה
2. rush להתקנת ruhs מדריך שיצר @אבי_770 // את הפקודה שבמדריך צריך להריץ ב PowerShell ולא ב cmd
3. ידע שפת java
4. עורך קוד אני ממליץ על visual code נוריד אותו מכאן ונתקין
   (כמובן אפשר גם לערוך עם כל עורך טקסט אך לא מומלץ)

מומלץ גם IntelliJ או אנדרואיד סטודיו כדי לנפות באגים במחלקות האנדרואיד המובנות //בעקרון אפשר להשתמש בזה כתחליף לעורך קוד, זה כולל גם השלמת קוד של מחלקות ומתודות (פונקציות) של אנדרואיד (מה שלא קיים ב visual code)

ניצור פרויקט (ניתן לראות במדריך של @אבי_770)

1. שם הפרויקט
   2.שם החבילה (package name)
2. כותרת
3. מספר גרסה
4. בחירת שפה, java או kotlin (ניתן לזוז עם החיצים במקלדת, או עם w ו s), נבחר ב java.
5. שם שהתיקייה של ההרחבה

נקיש cd ואת שם התיקייה של ההרחבה //לכניסה לתיקייה

הקובץ שעליו נעבוד קובץ עם סיומת java .
(או kt אם בחרתם בהרחבה בשפת kotlin, הדוגמאות במדריך יהיו על java)
את הקובץ נמצא בתיקיית src/your/package/name
במקום your/package/name זה יהיה השם חבילה שבחרתם)\

נפתח את הקובץ, זה יראה בערך כך:

נמחק את זה:

  @SimpleFunction(description = "Returns the sum of the given list of integers.")
  public int SumAll(YailList integers) {
    int sum = 0;

    for (final Object o : integers.toArray()) {
      try {
        sum += Integer.parseInt(o.toString());
      } catch (NumberFormatException e) {
        throw new YailRuntimeError(e.toString(), "NumberFormatException");
      }
    }

    return sum;
  }

נוסיף מתחת ל import:

import android.app.Activity;
import android.content.Context;
import com.google.appinventor.components.common.ComponentCategory;
import com.google.appinventor.components.runtime.EventDispatcher;
import android.widget.*;

יצירת בלוקים
בלוק = מתודה (פונקציה)
הערכים שהמתודה מקבלת יהפכו ל ערכים שניתן להכניס בבלוק
והערך שהיא מחזירה ייהפך לבלוק שניתן להכניס

לפני המתודה יש לכתוב הערה בשביל שהמהדר ידע שצריך ליצור בלוק:

@SimpleFunction(description = "כאן נכתוב הסבר על הבלוק")

יצירת ההרחבה הראשונה.
ההרחבה הראשונה רק תקבל שתי מספרים ותחזיר כמה שווה המשתנה הראשון + השני
נדביק מתחת ל class

 @SimpleFunction(description = "return c1 + c2 ")
public String Calculator(String c1, String c2) {
     return c1 + c2; //החזר t1 + t2
     }

הסבר:

(String c1, String c2)

המתודה מקבלת שתי משתנים מסוג String

     return c1 + c2; 

nחזיר כמה זה שווה c1 +c2
ונשמור (ctrl + s)
נקליד ב PowerShell

rush build

זה מראה שהוא הצליח אם יש כיתוב באדום זה מראה שיש שגיאות
(אם יש שגיאה כתוב את מספר השורה ומספר התו בשורה שיש את השגיאה וסיבת השגיאה)

הקובץ של ההרחבה נמצא בתיקיית out
מזל טוב! יצרתם את ההרחבה הראשונה שלכם

נעלה את ההרחבה לקודולר ונגרור אותה למסך.

המדריך בעריכה.
נא לא להגיב!!! לכל הערה/הארה/הצעה וכו' לשלוח לי בצ'אט, או לפתוח נושא בעזרה הדדית, או למייל office@y-fox.com!