שיעור 1. הגדרת סביבת הפיתוח

מדריך: יצירת תוספים עבור FreeCAD

מטרת השיעור: להכין את כל מה שנחוץ כדי ליצור, לבדוק ולנפות תוספים בקלות וביעילות.

---

שלב 1. ודא ש-FreeCAD מותקן
דרישות:

• גרסת FreeCAD 0.20 או חדשה יותר (מומלץ 1.0+)
• עובד ב-Windows, Linux או macOS

אם טרם התקנת את FreeCAD – הורד מהאתר הרשמי:
https://www.freecad.org/downloads.php

בחר לפי מערכת ההפעלה שלך:

• Windows: .exe (אינסטלر) או .7z (גרסת ניידת)
• Linux: AppImage או חבילת הפצה
• macOS: .dmg

טיפ: למטרות למידה, עדיף להשתמש בגרסה מותקנת (באמצעות אינסטלר) – היא יציבה יותר וקל יותר להגדיר אותה.

---

שלב 2. מציאת תיקיית התוספים
FreeCAD מחפש תוספים מותאמים אישית בתיקייה מיוחדת בשם Mod.

הנתיב משתנה לפי מערכת ההפעלה וסוג ההתקנה.

איך למצוא את התיקייה בדיוק?

1. פתח את FreeCAD
2. פתח את Python Console:
   View → Panels → Python console
3. הקלד את הפקודה הבאה:

   import FreeCAD
   print(FreeCAD.getUserAppDataDir())

4. הקש Enter

תראה נתיב, למשל:

• Windows (גרסה מותקנת):
  C:\Users\YourName\AppData\Roaming\FreeCAD\
• Windows (גרסה ניידת):
  D:\FreeCAD\data\
• Linux:
  /home/your_name/.local/share/FreeCAD/
• macOS:
  /Users/your_name/Library/Application Support/FreeCAD/

צור את תיקיית Mod
בתוך התיקייה הזו, חייבת להיות תיקיית Mod.
אם היא לא קיימת – צור אותה ידנית.

דוגמה ל-Windows:
C:\Users\YourName\AppData\Roaming\FreeCAD\Mod\

דרך מהירה לפתוח את התיקייה ב-Windows:
לחץ Win + R → הקלד %APPDATA%\FreeCAD → Enter

---

שלב 3. הגדרת עורך טקסט (אופציונלי, אך מומלץ מאוד)
אפשר לכתוב קוד ב-Notepad, אך נוח יותר להשתמש בעורך עם:

• הדגשת תחביר פייתון
• השלמה אוטומטית
• אפשרות להריץ סקריפטים

מומלץ: Visual Studio Code (VS Code)

1. הורד והתקן מ-https://code.visualstudio.com/
2. התקן את ההרחבה Python (מאת Microsoft)
3. (אופציונלי) התקן את ההרחבה FreeCAD for VS Code – מוסיפה רמזים ל-API של FreeCAD

איך לפתוח את תיקיית התוספים ב-VS Code?

1. פתח את VS Code
2. File → Open Folder
3. בחר את תיקיית Mod (או תיקיית תוסף ספציפית בתוכה)

כעת תוכל לראות את מבנה הפרויקט ולערוך קבצים בנוחות.

---

שלב 4. הכר את הכלים המובנים של FreeCAD
FreeCAD כולל כבר את כל מה שצריך לפיתוח:

1. Python Console
   תפריט: View → Panels → Python console
   מאפשר להריץ פקודות בזמן אמת
   דוגמה: הקלד App.newDocument() → ייווצר מסמך חדש
2. Report View
   תפריט: View → Panels → Report view
   מציג שגיאות, אזהרות ורישומים
   תמיד שמור על זה פתוח כשאתה בודק תוסף!
3. Macro Recorder
   תפריט: Macro → Macros...
   לחצן Record – מקליט את הפעולות שלך כקוד פייתון
   דרך מצוינת ללמוד את ה-API של FreeCAD נסה זאת:
4. לחץ Macro → Start recording
5. צור תיבה (Part → Box)
6. עצור הקלטה
7. פתח את המקרו – תראה את הקוד האמיתי ליצירת האובייקט!

---

שלב 5. אימות: צור תיקיית בדיקה
כדי לוודא שהכול עובד:

1. בתיקיית Mod, צור תת-תיקייה: TestAddon
2. בתוכה, צור קובץ ריק בשם __init__.py – זה אומר ל-Python שזאת מודול
3. הפעל מחדש את FreeCAD
4. פתח את Report view

אם אין שגיאות – זה אומר ש-FreeCAD סרק בהצלחה את תיקיית Mod.
אם מופיעה שגיאת ImportError – בדוק:

• שם התיקייה תקין (ללא רווחים או תווים לא לטיניים)
• קובץ __init__.py קיים (לא חובה בגרסאות חדשות, אך מומלץ להוסיף)

---

מבנה תיקיית המפתח (סיכום)
בסוף השיעור הזה, תצפו למבנה כזה:

(FreeCAD user folder)
└── Mod/
    └── TestAddon/
        └── __init__.py  ← יכול להיות ריק

וכבר תדעו:

• איפה נמצאת תיקיית Mod
• איך לפתוח את Python Console ו-Report View
• איך להשתמש ב-Macro Recorder
• איך להגדיר את VS Code (אופציונלי)

---

משימה מעשית

1. מצא את תיקיית Mod באמצעות FreeCAD.getUserAppDataDir()
2. צור תיקייה בשם MyFirstAddon בתוך Mod
3. הוסף קובץ ריק בשם __init__.py
4. הפעל מחדש את FreeCAD
5. ודא שאין שגיאות ב-Report view

מטרה: FreeCAD יופעל ללא שגיאות ו"יראה" את התיקייה שלך.

---

מה הלאה?
בשיעור 2 ניצור תוסף אמיתי:

• נוסיף כפתור
• נעשה לו לבצע פעולה
• נלמד לרשום פקודות וסביבות עבודה

---