מדריך לקוד המקור של התוכנה
מתוך FreeMap
תוכן עניינים |
ניהול והפצת קוד המקור
המטרה במדריך זה היא להביא את ההנחיות הבסיסיות לגישה לקוד המקור של הפרויקט והשימוש בו על מנת להכניס תיקונים ושיפורים ע"י מפתחים רבים ככל שניתן.
פרויקט FreeMap הוא הרחבה של פרויקט RoadMap ושניהם פרויקטים המפותחים תחת רשיון GNU General Public Licence - GPL. מטרתו המרכזית של פרויקט RoadMap היא יצירת תוכנת ניווט בקוד פתוח, והוא מתבסס על קיומם של מפת כבישים דיגיטלית ממקורות חופשיים אחרים. מטרתו המרכזית של פרויקט FreeMap היא לאפשר יצירה של מפות כבישים דיגיטלית כאלו ע"י איסוף נתוני GPS בזמן הנסיעה בכבישים. השימוש שנעשה בקוד של RoadMap בפרויקט FreeMap הביא עם הזמן לפיתוח אפשרויות ניווט שלא היו קיימות ב-RoadMap, כגון הניווט מדלת לדלת.
קוד המקור כתוב בשפת C. פרויקט FreeMap מיועד לבניה עבור מחשבי כף-יד ממשפחת PocketPC או Windows Mobile, עבור מחשבים אישיים עם מערכת הפעלה Windows-XP ולמכשירים סלולריים עם JME 2.0. פרויקט RoadMap נבנה בתחילה עבור מערכות Unix, ויש לו גם גרסאות ל-PocketPC ול-Sharp Zaurus.
ניתן לצפות בקוד המקור גם דרך ממשק ה-Web
מערכות הפעלה נתמכות:
- WIndows Mobile
- Symbian
- Android
- iPhone
מדריך מקוצר - יצירת גרסה עבור WindowsCE על מחשב Windows XP
- להוריד ולהתקין את WinCVS על מחשב ה-XP
- להפעיל את WinCVS ולהוריד את גירסת הקוד האחרונה של FreeMap ע"י ...Remote->Checkout Module כאשר:
- CVSROOT: :pserver:anonymous@roadmap.cvs.sourceforge.net:/cvsroot/roadmap
- Module name and path on the server: roadmap_editor
- לקבוע את המחיצה אליה יכנס הקוד - :Local folder to checkout to
- OK
- לתת OK על הסיסמה הריקה
- להוריד ולהתקין על המחשב את eMbedded Visual C++ 4.0, את Service Pack 4 שלו, ואת SDK for Windows Mobile 2003-based Pocket PCs.
- לפתוח את roadmap_editor\src\win32\wince_env\Roadmap.vcw ע"י ++eVC.
- בפתיחה הראשונה
- ללחוץ על Cancel על בקשות לקבצי vcp. כמו ComSplit.vcp ,driver_test.vcp ו-rdmfriends.vcp
- בסרגל התחתון מבין הארבעה - "WCE Configuration" - לבחור: "FreeMap" "POCKET PC 2003" "Win32 (WCE ARMV4) Release" "Pocket PC 2003 Device"
- לבחור Tools->Select Remote Tools->Use WCE420 Tools
- להעתיק התקנה של FreeMap במכשיר כף היד למחיצה חדשה
- להכניס את שם המחיצה החדשה אל Project -> Settings -> Debug -> General -> Download Directory
- (Build -> Build Roadmap.exe (F7 או (Build -> Execute Roadmap.exe (Ctrl+F5
המדריך המלא
ניהול גירסאות הקוד
אתר SourceForge.net
קוד המקור של פרויקט FreeMap נשמר כחלק מקוד המקור של פרויקט Roadmap באתר SourceForge.net. אתר זה מאכסן קוד פרויקטי קוד פתוח (open source) רבים. האתר מעיד על עצמו שהוא האתר הגדול ביותר בעולם לפיתוח קוד פתוח ויש בו למעלה מ-100,000 פרויקטים ו-1,000,000 משתמשים רשומים. הקוד וכל ההיסטוריה שלו נשמרים באמצעות מערכת לניהול גרסאות בשם CVS. כאן אפשר למצוא פרטים רבים נוספים על CVS והשימוש בו ב-SourceForge.net.
תוכנות CVS clients לניהול גירסאות
מערכת ה-CVS פותחה בראשיתה עבור מערכות Unix אך כיום ישנן מספר אלטרנטיבות CVS לסביבת Windows. במדריך זה נתמקד בתוכנת WinCVS.
את ההתקנה המלאה של WinCVS אפשר להוריד מכאן. באתר SourceForge.net יש הסבר מלא על התקנת WinCVS. כמשתמשים אנונימיים נשתמש בהגדרת CVSROOT :pserver:anonymous@roadmap.cvs.sourceforge.net:/cvsroot/roadmap ונוריד את ה-module ששמו roadmap_editor
מי שמעוניין לבנות את FreeMap או RoadMap למערכת Linux יכול להשתמש בגרסת cvs המופצת עם (רוב) מערכות ה-Linux.
שליחת עידכונים
רב המשתמשים בתוכנה מורידים גרסאות הבנויות מראש למערכת ההפעלה שלהם מדף הורדת התוכנה. אהוד אחראי על שחרור גרסאות פומביות או גרסאות בפיתוח, ולכן השיטה הנוכחית לשילוב קוד ממפתחים אחרים היא שליחת השינויים בקוד לאהוד על מנת שישלב אותם בגרסה הבאה. את השינויים אפשר להציג ע"י ביצוע פקודת diff על המחיצה העליונה של הפרויקט - roadmap_editor: ב-WinCVS הגישה לפקודת ה-diff נעשית ע"י הלחצן הימני של העכבר, ובלינוקס - ע"י פקודת cvs diff -u.
סביבות הפיתוח
עבור WindowsCE
פיתוח התוכנה לסביבת Windows CE נעשה בסביבת Windows XP (או Windows 2000) תוך שימוש בסביבת eVC++[ eMbedded Visual C++ 4.0] שניתן להוריד בחינם מאתר Microsoft Windows Embedded Developer Center.
- ראשית יש להתקין את גירסת הבסיס של eMbedded Visual C++ 4.0
- שימו לב שמיקרוסופט מפרסמת את המפתח להתקנת התוכנה בפסקת ה-Instructions שבדף.
- לאחר מכן יש להתקין את ה-Service Pack העדכני ביותר. נכון לרגע כתיבת שורות אלו, זהו eMbedded Visual C++ 4.0 Service Pack 4.
- להתקין גם את SDK for Windows Mobile 2003-based Pocket PCs
הערה: עקרונית ניתן להשתמש גם ב-Visual Studio 5.0 עם התקנת ה-SDK המתאים. עד כה לא דווח אם מישהו אכן עשה זאת.
הכנת המכשיר
eVC++ יכול להעתיק את התוכנית שבנה על מכשיר כף היד ולהריץ אותה. התוכנית תצפה למצוא שם את שאר הקבצים הנחוצים להפעלה. לכן יש להעתיק את כל הקבצים ממחיצת ההתקנה של FreeMap למחיצה חדשה.
הפעלה ראשונית של ++eMbedded Visual C
קוד המקור מכיל כבר את קובץ הגדרות (Workspace) של הפרויקט עבור ++roadmap_editor\src\win32\wince_env\Roadmap.vcw :eVC - אותו יש לפתוח עם eVC++.
- בפתיחה הראשונה של הקובץ Roadmap.vcw יתכן ונתבקש לאתר קבצי vcp שלא נמצאו כגון: ComSplit.vcp ,driver_test.vcp ו-rdmfriends.vcp. אפשר לתת Cancel ללא חשש.
- לאחר פתיחת הקובץ יש לקבוע את ה-WCE Configuration באמצעות הסרגל הרביעי: "FreeMap" "POCKET PC 2003" "Win32 (WCE ARMV4) Release" "Pocket PC 2003 Device".
- לבחור Tools->Select Remote Tools->Use WCE420 Tools
- את שם המחיצה אליה הועתקה התקנת FreeMap יש להכניס אל Project -> Settings -> Debug -> General -> Download Directory
בניה והפעלה
- הבניה מתבצעת ע"י (Build -> Build Roadmap.exe (F7
- העתקת התוכנית למכשיר כף היד והפעלתה נעשית ע"י (Build -> Execute Roadmap.exe (Ctrl+F5
- הערות:
- בעבודה עם Windows Mobile 5.0 מתקבלות אזהרות לפיהן המעבד לא תומך בסיפריות, למשל:
-
- או על חוסר התאמה בין מערכת ההפעלה לקונפיגורציה שבחרנו:
-
- יש לענות Continue) Yes), ולשים לב שאין אזהרות מסוג אחר...
- ניתן לבנות את התוכנה גם בתצורת "Win32 (WCE ARMV4) Debug" ואז ניתן להריץ את התוכנה על המכשיר ולעשות DEBUG שורה אחר שורה. מומלץ מאד לעשות גיבוי של המידע לפני ניסיון כזה כיוון שלא פעם המכשיר נתקע כתוצאה מפעולת DEBUG ורק Hard Reset משחרר אותו...
-
עבור J2ME
גם קוד המקור עבור סביבת ה-J2ME משוחרר ברישיון GPL. למעשה חלקים רבים של התוכנה משותפים וכתובים בשפת C. חלקים אלו בתוספת קוד JAVA מרכיבים את התוכנה.
בניית הגרסה דורשת פרוייקט נוסף:
http://spel.bth.se/index.php/Cibyl
תחילה יש להתקינו ולבנות את הדוגמאות המגיעות איתו.
לאחר מכן ניתן להוריד את הקוד של FreeMap כמו שמתואר למעלה.
בספרייה J2ME יש להריץ make.
עבור סימביאן
פיתוח עבור סימביאן, מומלץ לבצע בסביבת Carbide במערכת הפעלה ווינדוס (XP או Vista) בלבד.
התקנת סביבת הפיתוח
ראשית, יש להוריד את Carbide.C++ מפה. לאחר ההתקנה, תתבקשו להוריד את perl מגרסה ישנה. עכבו אחר הוראות ההתקנה. לאחר מכן, יש להתקין S60 platform SDK. ישנן מספר גרסאות התלויות בסוג המכשיר שברשותכם, שניתן להורידן מכאן.
כרגע אתם אמורים להיות מסוגלים לקמפל את תוכניות הדוגמה שמגיעות עם ה sdk שברשותכם.
הורדת קוד המקור
ניתן להוריד קוד מקור שמוכן לקימפול ב Carbide מפה. שמרו את כל עץ הפיתוח, פתחו את הזיפ, והעתיקו את התוכן למחיצה, שלצורך העניין תקרא waze-src.
קימפול הקוד
פתחו את Carbide.c++. בשלב ראשון, תתבקשו להכניס את הספרייה ל- Workspace. בחרו ב-C:\Symbian\Carbide\waze.
לאחר שתאשרו, תגיעו למסך שכותרתו Welcome. סיגרו אותו. גשו לתפריט File=>Import.... בחרו בתפריט Symbian OS, ובתוכו באופציה Symbian OS bld.inf. לחצו על הכפתור Browse. נווטו למחיצה שבה שמרתם את קובצי המקור, waze-src, ובתוכה מצאו את הספרייה שנקראת group, ובחרו את הקובץ bld.inf.
כעת יופיע חלון שכותרתו Symbian OS SDKs. אם התקנתם בהצלחה את ה- S60 SDK, אז בשלב זה הוא יופיע. סמנו את הקונפיגורציות שברצונכם לקמפל. לשימוש ראשוני, מומלץ לבחור רק ב- Emulator Debug(WINSCW). לחצו על Next עד סיום התהליך. על מנת לבנות את התוכנה, לחצו על התפריט Project=>Build Project. על מנת להריץ את התוכנה באמולטור, לחצו על Ctrl+F11. לאחר מספר שניות תתחיל התוכנית בתוך האמולטור. שימו לב שמכיוון שאין נתוני GPS מעודכנים באמולטור, מקומכם איננו ליד שום כביש.
חזרה לעמוד ראשי
