pure::variants – מחבר עבור
מדריך לניהול קוד מקור
Parametric Technology GmbH
גרסה 6.0.7.685 עבור pure::variants 6.0
זכויות יוצרים © 2003-2024 Parametric Technology GmbH
2024
מָבוֹא
pure::variants מחבר לניהול קוד מקור (Connector) מאפשר למפתחים לנהל שונות קוד מקור באמצעות pure::variants. ניהול קוד המקור של pure::variants מספק הזדמנות גמישה לסנכרן מבני ספריות וקוד מקור fileזה בקלות עם דגמי pure::variants. לפיכך, ניהול גרסאות יכול ליישם מעשי אפילו על פרויקטי תוכנה מורכבים. יתר על כן, חיבורים בין תכונות pure::variants וקוד המקור עשויים להיות מנוהלים בקלות רבה יותר עם ה-Builder והם נגישים מאוד באמצעות ניהול קוד המקור.
1.1. דרישות תוכנה
ה-pure::variants Connector לניהול קוד מקור הוא הרחבה עבור pure::variants וזמין בכל הפלטפורמות הנתמכות.
1.2. התקנה
אנא עיין בסעיף pure::variants מחברים במדריך ההתקנה pure::variants לקבלת מידע מפורט על אופן התקנת המחבר (תפריט עזרה -> תוכן עזרה ולאחר מכן pure::variants מדריך התקנה -> pure::variants מחברים).
1.3. על מדריך זה
הקורא צפוי להיות בעל ידע בסיסי והתנסות עם הוריאציות הטהורות::. אנא עיין בחומר המבוא שלה לפני קריאת מדריך זה. המדריך זמין בעזרה מקוונת כמו גם בפורמט PDF להדפסה כאן.
שימוש במחבר
2.1. החל pure::variants
בהתאם לשיטת ההתקנה שבה נעשה שימוש, התחל את ה-pure::variants-enabled Eclipse או תחת Windows בחר את הפריט pure::variants מתפריט התוכנית.
אם הפרספקטיבה של ניהול וריאנטים עדיין לא מופעלת, עשה זאת על ידי בחירתה מתוך פתח פרספקטיבה->אחר... בתפריט החלון.
2.2. ייבא עץ ספריות למודל משפחתי
לפני ייבוא עץ ספריות למודל משפחתי, יש ליצור פרויקט גרסאות. כמו כן, מומלץ להגדיר כבר תכונות במודל תכונה. אנא עיין בתיעוד pure::variants לקבלת עזרה לגבי שלבים אלה.
הייבוא בפועל מתחיל על ידי בחירה בפעולה ייבוא... בתפריט ההקשר של הפרויקטים view או עם תפריט ייבוא... ב- File תַפרִיט. בחר דגמי וריאנטים או פרויקטים מהקטגוריה ניהול וריאנטים ולחץ על הבא. בעמוד הבא בחר ייבא דגם משפחתי מתיקיות מקור ולחץ שוב על הבא.
בחר את סוג קוד המקור לייבוא
אשף הייבוא מופיע (ראה איור 1, "עמוד של אשף הייבוא לבחירת סוג קוד המקור שניתן לייבא"). בחר סוג פרויקט לייבא ולחץ על הבא. כל סוג מכיל קבוצה מוגדרת מראש של file סוגים לייבא לדגם.
איור 1. עמוד של אשף הייבוא לבחירת סוג קוד המקור שניתן לייבא
בחר מקור ויעד
בדף האשף הבא (איור 2, "עמוד של אשף הייבוא לבחירת המקור והיעד לייבוא") יש לציין את ספריית המקור ואת מודל היעד.
לחץ על הלחצן עיון... כדי לבחור את הספרייה שבה קיים קוד המקור שיש לייבא. כברירת מחדל, סביבת העבודה הנוכחית נבחרת מכיוון שזו עשויה להיות נקודה שימושית לתחילת הניווט.
להלן תוכל לציין דפוס הכללה ואי הכללה. דפוסים אלה צריכים להיות ביטויים רגילים של Java. כל נתיב קלט, ביחס לתיקיית השורש של המקור, מסומן עם דפוסים אלה. אם תבנית הכלול תואמת, תיקייה מיובאת, אם תבנית אי הכללה אינה תואמת. כלומר, דפוס הכלולים בוחר מראש את התיקיות לייבוא, דפוס אי הכללה כן מגביל את הבחירה מראש.
לאחר בחירת ספריית קוד המקור יש להגדיר מודל יעד. לכן בחר פרויקט וריאנט או תיקיה שבה יש לאחסן את הדגם והזן שם דגם. ה file השם מורחב אוטומטית עם סיומת ccfm אם היא לא ניתנת בתיבת הדו-שיח הזו. כברירת מחדל הוא יוגדר לאותו שם כמו שם הדגם עצמו. זוהי ההגדרה המומלצת.
לאחר שצוינו תיקיית מקור שימושית ושם הדגם הרצוי, ייתכן שתסתיים תיבת הדו-שיח על ידי לחיצה על סיום. אם תלחץ על הלחצן הבא, יופיע דף נוסף שבו ניתן לבצע הגדרות נוספות.
איור 2. עמוד של אשף הייבוא לבחירת המקור והיעד לייבוא
שנה העדפות ייבוא
בדף האשף האחרון (איור 3, "עמוד של אשף הייבוא להגדרת תצורה בודדת”) ישנן העדפות שניתן לעשות כדי להתאים אישית את התנהגות הייבוא עבור פרויקט התוכנה המיובאת.
דף הדו-שיח מציג טבלה שבה file מוגדרים סוגים שיישקלו בתהליך הייבוא.
כל שורה מורכבת מארבעה שדות.
- השדה תיאור מכיל טקסט תיאורי קצר לזיהוי file סוּג.
- ה File שדה תבנית השם משמש לבחירה fileייבוא כאשר הם תואמים לערך השדות. השדה משתמש בתחביר הבא:
- מקרה השימוש הנפוץ ביותר עשוי להיות א file הַרחָבָה. התחביר הרגיל הוא .EXT, כאשר EXT הוא הרצוי file סיומת (למשל .java).
- מצב שכיח נוסף הוא מיוחד file, כמו תוצרתfile. לכן, אפשר להתאים על המדויק file שֵׁם. כדי לעשות זאת, פשוט הזן את file שם לתוך השדה (למשל build.xml).
- במקרים מסוימים רצונות המיפוי ספציפיים יותר, אז רק fileיש לייבא ים התואמים לתבנית מיוחדת. כדי להתאים לדרישה זו ניתן להשתמש בביטויים רגולריים ב- File שדה דפוס שם.
תיאור התחביר של ביטויים רגולריים יעלה על הכוונה של עזרה זו. אנא עיין בסעיף הביטויים הרגולריים של פרק ההתייחסות במדריך למשתמש pure::variants (למשל .*).
- השדה סוג רכיב ממופה מגדיר את המיפוי בין a file סוג וסוג אלמנט משפחתי טהור::variants. סוג האלמנט המשפחתי הוא מתאר עבור המקור file כדי לספק מידע נוסף לרכיב הממפה במודל המיובא. בחירות טיפוסיות הן ps:class או ps:makefile.
- המפות file שדה type מגדיר את המיפוי בין a file סוג ו- pure::variants file סוּג. ה file הקלד pure::variants הוא מתאר עבור המקור file כדי לספק מידע נוסף לרכיב הממפה במודל המיובא. בחירות טיפוסיות הן impl עבור יישומים או def עבור הגדרה files.
איור 3. עמוד של אשף הייבוא להגדרת תצורה בודדת
חָדָשׁ file ניתן להוסיף סוגים על ידי שימוש בלחצן הוסף מיפוי. כל השדות ממולאים בערך undefined ויש למלא אותם על ידי המשתמש. כדי לערוך ערך בשדה, פשוט לחץ על השדה עם העכבר. הערך הופך לניתן לעריכה וניתן לשינוי. לא ניתן לשנות את ברירת המחדל file תבניות שמות של השולחן. כדי להפוך התאמה אישית לגמישה, אפשר לבטל את הבחירה ב-a file הקלד על ידי ביטול הבחירה בשורה. בוטלה file תבניות שמות נשארות בתצורה אך לא ישמשו את היבואן. משתמש מוגדר file ניתן להסיר שוב סוגים על ידי שימוש בלחצן הסר מיפוי.
כברירת מחדל, אחר files file תבנית השם זמינה בטבלה אך בוטלה בבחירה. בדרך כלל לא רוצים לייבא את כולם fileאך ניתן לשנות זאת בקלות על ידי בחירת השורה המתאימה.
ישנן שלוש אפשרויות ייבוא כלליות להתאמה אישית של התנהגות היבואן.
- אין לייבא ספריות ללא התאמה files (למשל ספריות CVS).
אם היבואן מוצא ספרייה שבה אין התאמה file נמצא בו ובמקום לאף ספריית משנה אין התאמה file, הספרייה לא תיובא. זה שימושי לעתים קרובות אם פרויקטים מנוהלים על ידי מערכות ניהול גרסאות כמו CVS. עבור CVS, כל ספרייה רלוונטית מכילה ספריית CVS כאשר היא אינה רלוונטית files מאוחסנים. אם אפשרות זו נבחרה וה- CVS-files אינם תואמים לאף אחד file סוג שהוגדר לעיל, הספרייה לא תיובא כרכיב למודל המשפחתי. - סוּג files וספריות.
אפשר אפשרות זו למיון files וספריות כל אחד בסדר אלפביתי. - טיפול בנתיב ייבוא.
לסינכרון נוסף היבואן צריך לאחסן את הנתיב המקורי של כל האלמנטים המיובאים במודל.
במקרים רבים מודלים משפחתיים משותפים עם משתמשים אחרים. מבנה הספריות עשוי להיות שונה עבור כל משתמש. כדי לתמוך ברוב תרחישי השימוש הנפוצים, היבואן יכול לעבוד במצבים שונים:
| מוּחלָט | הנתיב המוחלט לאלמנט המיובא יאוחסן במודל. לסנכרון מאוחר יותר ובמהלך הטרנספורמציה את fileיש למקם אותו בדיוק באותו מיקום כמו במהלך הייבוא הראשון. |
| יחסית לעבודה | הנתיבים מאוחסנים ביחס לתיקיית סביבת העבודה. לסנכרון ה files חייב להיות חלק מסביבת העבודה Eclipse. על השינוי להשתמש בסביבת העבודה של Eclipse בתור ספריית קלט. |
| יחסית לפרויקט | הנתיבים מאוחסנים ביחס לפרויקט. לסנכרון ה fileהם חלק מהפרויקט בתוך Eclipse. על השינוי להשתמש בתיקיית הפרויקט כספריית קלט. |
| יחסית לנתיב | הנתיבים מאוחסנים ביחס לנתיב הנתון. לסנכרון ה fileיש למקם אותו בדיוק באותו מיקום. ספריית קלט השינוי זהה לנתיב היחסי במהלך הייבוא. |
כל ההעדפות של דו-שיח זה מאוחסנות באופן קבוע. אין לבצע את ההתאמות האישיות מחדש בכל פעם שהייבוא פועל. זה הופך את זרימת העבודה של הייבוא לקלה ומהירה.
2.3. עדכון מודלים מעץ המדריך
לחץ על כפתור סנכרון 
לסנכרן מודל מיובא עם נתיב הספרייה שלו. נתיב הבסיס של הפרויקט מאוחסן במודל כך שהוא יסונכרן לאותה ספרייה כמו קודם. כדי להפעיל את כפתור הסנכרון, פתח את הדגם ובחר אלמנט כלשהו. לאחר לחיצה על כפתור הסנכרון נפתח עורך השוואה שבו המודל המשפחתי הנוכחי והמודל של מבנה הספריות הנוכחי מנוגדים (ראה איור 4, "עדכון מודל מעץ ספריות בעורך ההשוואה").
איור 4. עדכון דגם מעץ Directory בעורך Compare 
עורך ההשוואה משמש לאורך pure::variants להשוואת גרסאות מודל, אך במקרה זה משמש להשוואת מבנה הספריות הפיזי (המוצג בצד ימין למטה) עם מודל pure::variants הנוכחי (צד שמאל למטה). כל השינויים רשומים כפריטים נפרדים בחלק העליון של העורך, מסודרים לפי הרכיבים המושפעים.
בחירת פריט ברשימה זו מדגישה את השינוי המתאים בשני הדגמים. באקסample, אלמנט נוסף מסומן בקופסה בצד ימין ומחובר למיקום האפשרי שלו בדגם בצד שמאל. סרגל הכלים מיזוג בין חלונות עורך עליון ותחתון מספק כלים להעתקת שינויים בודדים או אפילו את כל השינויים (הלא מתנגשים) כמכלול ממודל עץ הספריות למודל התכונות.
פֶּתֶק
הסנכרון מתבצע עם הגדרות היבואן האחרונות שבהן השתמשו. זה מאפשר לעדכן את הדגם עם הגדרות אחרות כפי שנעשו בזמן הייבוא.
שימוש ב-Relation Indexer
המחבר לניהול קוד מקור משפר את היחסים View עם מידע על קשרים בין רכיבי מודל pure::variants וקוד המקור. מתווספים קשרים עבור תכונות המשמשות בתנאים של הרכיבים ps:condxml ו-ps:condtext.
עבור ps:flag ו-ps:flagfile אלמנטים את המיקום של קבועי קדם-מעבד במקור C/C++ fileמוצגים s. בנוסף, המיקומים של קבועי קדם-מעבד תואמים מוצגים עבור תכונה נבחרת על-ידי שימוש במיפוי בין שמות ייחודיים של תכונה וקבועי קדם-מעבד.
3.1. הוספת אינדקס היחסים לפרויקט
ניתן להפעיל את אינדקס היחסים בדף מאפייני פרויקט מיוחד. בחר את הפרויקט ובחר בפריט מאפיינים בתפריט ההקשר. בתיבת הדו-שיח הקרובה בחרו בדף אינדקס היחסים.
איור 5. דף נכסי פרויקט עבור אינדקס היחסים
אינדקס היחסים מופעל עבור הפרויקט על ידי בחירה באפשרות Enable Relation Indexer (1). לאחר הפעלת האינדקס ישנן כמה אפשרויות נוספות להגדיר את ההתנהגות הספציפית לפרויקט. ניתן להפעיל בנפרד את האינדקס של תנאים טהורים::variants ו-C/C++ Preprocessor Constants (2). הרשימה עם file תבניות שמות (3) משמשות לבחירת files לאינדקס. רַק files התואמים לאחת התבניות נסרקות. הוסף את ה-"*" כתבנית כדי לסרוק הכל files של פרויקט.
לאחר הפעלת האינדקס לפרויקט מתווסף בונה לפרויקט. סריקות בונה זה השתנו files ליחסים חדשים ל-pure::variants מודל אלמנטים באופן אוטומטי.
3.2. היחסים לקוד המקור
עם אינדקס יחס מופעל היחסים View מכיל ערכים נוספים. ערכים אלה מציגים את השם של file ומספר הקו של נקודת הגרסה. טיפ הכלי מציג את הקטע המתאים של file. על ידי לחיצה כפולה על הערך file ייפתח לעורך.
pure::variants תנאים
ניתן להשתמש במצב pure::variants כדי לכלול או לא לכלול קטעים של a file בהתאם לבחירת תכונה. ה-Condition Indexer סורק לאיתור כללים כאלה ומחלץ את התכונות המוזכרות. אם תכונה כזו נבחרה בעורך, ה-Relations View יראה הכל files וקווים שבהם נמצא מצב עם התכונה שנבחרה (ראה איור 6, "ייצוג של מצב ביחסים View”).
איור 6. ייצוג מצב ביחסים View
כדי לקבל הסבר מפורט כיצד להגדיר תנאים, עיין בסעיף ps:condtext של פרק 9.5.7 של המדריך למשתמש הטהור::variants (הפניה–>סוגי מקור מוגדרים מראש–>ps:condtext).
קבועי קדם-מעבד C/C++
ה-C/C++ Preprocessor Indexer סורק files עבור קבועים המשמשים בכללי קדם-מעבד (למשל #ifdef, #ifndef, ...).
אם ps:flag או ps:flagfile הרכיב נבחר ב-Relations View מציג את השימוש בקבוע הפרה-מעבד המוגדר.
היחסים View מציג גם קבועי קדם-מעבד המחוברים לתכונות באמצעות תבניות מיפוי. לשם כך התבניות מורחבות עם הנתונים של התכונה שנבחרה. הסמלים המתקבלים משמשים לחיפוש קבועי קדם-מעבד תואמים. איור 7, "ייצוג של קבוע C/C++ Preprocessor במערכות היחסים View"מראה אקסample עם תהילת הדפוס {שם}. הדפוס מורחב עם השם הייחודי של התכונה ל-fameNative. בקוד האינדקס יש 76 מיקומים שבהם נעשה שימוש ב-preprocessor constant fameNative.
מיקומים אלה מוצגים בקשרים View. ניתן להגדיר את הדפוסים בהעדפות (ראה סעיף 3.3, "ההעדפות").
איור 7. ייצוג של קבוע C/C++ Preprocessor במערכות היחסים View
3.3. ההעדפות
כדי לשנות את התנהגות ברירת המחדל של האינדקס פתחו את העדפות Eclipse ובחרו בדף Relation Indexer בקטגוריית Variant Management. העמוד מציג שתי רשימות.
איור 8. דף העדפות של אינדקס קשרים
הרשימה העליונה מכילה את ברירת המחדל file תבניות עבור האינדקס (1). רשימה זו היא הגדרת הדפוס הראשוני עבור פרויקטים שהופעלו לאחרונה.
הרשימה התחתונה מכילה את המיפוי בין תכונות וקבועי קדם-מעבד (2). מיפוי זה משמש עבור כל הפרויקטים. טבלה 1, "החלפות מיפוי נתמכות" מציגה את כל ההחלפות האפשריות.
טבלה 1. החלפות מיפוי נתמכות
| תו כללי | תֵאוּר | Example: FeatureA |
| שֵׁם | השם הייחודי של התכונה שנבחרה | FLAG_{Name} – FLAG_FeatureA |
| שֵׁם | האותיות הגדולות שם ייחודי של התכונה שנבחרה | FLAG_{NAME} – FLAG_FEATUREA |
| שֵׁם | האותיות הקטנות שם ייחודי של התכונה שנבחרה | flag_{name} – flag_featurea |
מסמכים / משאבים
 |
מחבר pure-systems 2024 עבור תוכנת ניהול קוד מקור [pdfמדריך למשתמש 2024, 2024 מחבר עבור תוכנת ניהול קוד מקור, מחבר עבור תוכנת ניהול קוד מקור, תוכנת ניהול קוד מקור, תוכנת ניהול, תוכנה |
