יצירת מתקין ב-WiX להפצת יישומים משודרגים

סביבה

סטודיו חזותי

• Visual Studio Community 2017
• Visual Studio Community 2019

ערכת הכלים של WiX

3.11.2

※ זה עובד בגרסאות אחרות, אבל זה לא מאושר

בהתחלה

למד כיצד ליצור מתקין בעת שדרוג יישום. הוא מבוסס על המאמר על ההליך של יצירת הגירסה הראשונה של המתקין. ייתכנו הבדלים באופן שבו אתה עושה את זה.

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

הכנה מראש

• הגירסה הראשונה של תוכנית ההתקנה נוצרה והפרוייקט קיים.

אודות סוגי שדרוג

קיימות מספר שיטות שדרוג לשדרוג כאמור במאמר הבא. ההליך כאן מתאר שדרוג גדול. אלא אם כן יש לך נסיבות מיוחדות, זה בסדר.

• סוג התקנת המדריך של מתקין Windows Part.7

Product.wxs משתנה

הפעל את Visual Studio ופתח את הפרוייקט (קובץ הפתרון) שכבר יצרת.

פתח את Product.wxs ושנה את הפרמטרים הבאים:

Wix/מוצר/@Id

החלף מזהה זה ב- GUID החדש אם אתה מבצע שדרוג ראשי.

אין צורך לשנות שדרוגים משניים ושדרוגים קטנים, אך הם חורגים מהטווח של מסמך זה.

<Wix>
  <Product Id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />

Wix/מוצר/@Version

הוא משמש כדי לקבוע אם היא גירסה חדשה יותר במהלך ההתקנה, לכן הגדל את המספר מהגירסה הקודמת. ישנם ארבעה מספרים של "גירסה ראשית.version.revision.build", ישנם שלושה דברים הקובעים אם גירסה עלתה: version.minor version.revision.

ככל שהמספר גדל, זה יכול להיות כל מספר, אבל בעיקרון זה בטוח להתאים אותו עם הגירסה של היישום.

<Wix>
  <Product Version="1.8.0.0" />

Wix/מוצר/@UpgradeCode

קוד זה מזהה אם זהו שדרוג גירסה לאותו יישום. לכן, אם ברצונך לשדרג עם התקנה מתחלפת, אל תשנה אותו מהקוד כאשר הוא שוחרר לראשונה.

לעומת זאת, אם ברצונך להתקין אותו כיישום נפרד למרות שהוא שדרוג גירסה, החלף אותו ב- GUID חדש.

<Wix>
  <Product UpgradeCode="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">

Wix/מוצר/שדרוג גדול/@DowngradeErrorMessage

הודעה זו מוצגת בעת הפעלת תוכנית ההתקנה הישנה עם גירסה חדשה יותר של היישום המותקנת. הוא משמש עבור גירסאות ישנות יותר של תוכנית ההתקנה, כך שאם כבר הגדרת הודעות בגירסאות קודמות, אין צורך לשנות אותן. אם ברצונך לשנות אותו, אנא כתוב אותו מחדש.

אם ברצונך להציג יפנית, עליך להגדיר את התכונות של שפות וקוקוד סיכום ליפנית (תמיכה ביפנית מוצגת במאמר נפרד). ProductName מוחלף בשם המוצר.

<Wix>
  <Product>
    <MajorUpgrade DowngradeErrorMessage="すでに新しいバージョンの [ProductName] がインストールされているため、インストールを中断します。" />

כיצד להתקין קבצים

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

עדכן רשיון.rtf

אם ברצונך לשנות את הסכם הרשיון המוצג במסך ההתקנה, נא שנה את התוכן.

עדכון פרטי קובץ התקנה של Product.wxs

* אין צורך לעבוד על פריט זה אם תצורת הקובץ או התיקיה שיש להתקין לא השתנתה כלל מהגירסה הקודמת.

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

השק את WixEdit.

פתח את הקובץ Product.wxs.

בחר קבצים מהסמל מימין. מחק את התיקיות מתחת לתיקיית קבצי התוכניות.

לחץ באמצעות לחצן העכבר הימני על התיקיה ProgramFilesFolder ובחר יבא תיקיה.

בחר את התיקיה שבה ברצונך להתקין את הקבצים.

ערכת קבצים נוספת לעץ.

כדי לשייך לפרמטרים אחרים, בחר את התיקיה שנוספה והגדר את "מזהה" בחזרה ל- "INSTALLFOLDER".

צור קיצור דרך עבור תפריט התחלה. מכיוון שעבודת יצירת קיצורי דרך זו הופכת לאותה עבודה בכל פעם, ייתכן שיהיה מהיר יותר לשמור את קוד ה- XML ולהדביק אותו מאוחר יותר. (חלק בחירה של התמונה להלן)

בחר "חדש" ו"קיצור דרך" מתפריט הלחיצה הימנית של קובץ האקס.

בעת הוספת קיצור דרך, בחר אותו ולחץ באמצעות לחצן העכבר הימני על הריק כדי להוסיף את המאפיין.

הוסף את הפרמטרים הבאים: (שנה את השם הייחודי כך שיתאים לתוכנית).)

לאחר מכן בחר בכרטיסיה "תכונה".

הוסף קבצים שהוספת ומחק את כל הקבצים שאין צורך עוד.

אם אתה נתקל בבעיות בעבודה עם ממשק המשתמש, באפשרותך לערוך את ה- XML ישירות.

שמר.

אישור בנייה וביצוע

בנה אותו ב- Visual Studio וצור מתקין.

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

כמו כן, נסה לוודא שאין באפשרותך להתקין את הגירסה הקודמת של תוכנית ההתקנה בעת הפעלת תוכנית ההתקנה כאשר מותקנת אצלך גירסה חדשה.