اموزش نرم افزار کاربردی Nsis

[سهند]

سعي ميكنم كه با دو مثال چگونگي ساخت كلي فايل هاي Setup با استفاده از برنامه NSIS را شرح دهم كه
شما ميتوانيد كد هاي گقته شده را بعنوان يك فرمول كلي در اكثر موارد استفاده نمائيد.

كد ها را طوري نوشته ام كه شما براي ساخت هر نوع Setup فقط لارم داريد كه چند تا نام را در داخل كد ها
تغيير دهيد.
و يا در صورت نياز ميتوانيد دستوراتي را از داخل كد ها حذف كرده و يا دستوراتي را برابر نيازتان براي موارد مختلف
چندين بار تكرار كنيد.

مسلم است كه بايستي مطالبي كه شرح داده مي شود را با دقت كافي مطالعه كرده و وقت كافي جهت تمرين
مطالب گفته شده بگذاريد.

توضيح:
====
با روشي كه توضيح داده ميشود، در انتهاي كار شما فرمولي را خواهيد داشت كه با استفاده از آن ميتوانيد انواع
نصب هاي اتوماتيك عمومي را بسازيد.
ولي در اين فرمول جائي براي Uninstall كردن و يا وارد كردن پاره اي از اطلاعات نيست. يعني با اين روش در حقيقت
ما داريم يك Extractor اتوماتيك درست مي كنيم. بطور ديگر بگويم با اين روش ما داريم كپي شدن تعدادي فايل و پوشه
را بجا هاي دلخواهمان و يا اجراي يك فايل رجستري را بصورت اتوماتيك انجام مي دهيم.

براي داشتن يك Setup كامل بايد بطور ديگري عمل كرد مثلا" استفاده از يرنامه هاي مخصوص اين كار. ولي بهر حال
اين روش هم در بسياري از موارد كاملا" كار ساز و كافي است.

مثال (1)
=========
فرض مي كنيم كه:
1. پوشه اي بنام A داريم كه در داخل آن تعدادي فايل و چند تا پوشه مختلف وجود دارند كه فايل اصلي قابل اجرا
بنام AAA.exe هم داخل اين پوشه مي باشد.

2. ميخواهيم بعد از ست آپ پوشه اي بنام AAA درون پوشه Program Files درست شده و تمام محتويات پوشه
A درون آن كپي شوند.

3. ميخواهيم پوشه اي بنام AAA درون منوي استارت درست شده و در داخل آن يك شورت كات براي فايل AAA.exe
گذاشته شود.

4. ميخواهيم كه يك شورت كات ديگر براي فايل AAA.exe در دسكتاپ درست شود.

5. يك فايل رجستري بنام do.reg داريم كه ميخواهيم در پايان كار اين فايل اجرا شود.

6. مي خواهيم كه فايلي بنام xxx.exe درست كنيم كه آيكن دلخواه ما را داشته باشد و بتواند تمام اعمال بالا را
بطور اتوماتيك و محفيانه انجام دهد.

براي ساخت فايل xxx.exe توسط NSIS به شرح زير عمل ميكنيم:

1.در روت يكي از درايو ها پوشه اي بنام فرضا" Sahand درست كنيد (مثلا" D:\Sahand).

2. پوشه A را با محتوياتش درون پوشه D:\Sahand كپي كنيد.

3. فايل رجستري do.reg را هم درون پوشه D:\Sahand كپي كنيد.

4. آيكني را كه ميخواهيد فايل نهائي داراي اين آيكن باشد را تهيه نموده و آن را با نام mcs.ico درون پوشه
D:\Sahand كپي نمائيد.

5. برنامه notepad را اجرا كرده و سپس متن زير را درون آن كپي نموده و سپس آن را با نام فرضا" xxx.nsi
درون پوشه D:\Sahand در كنار بقيه فايل ها ذخيره كنيد:

!include registry.nsh
SetCompressor ZLIB

InstallDir "$PROGRAMFILES\AAA"
OutFile "xxx.exe"
Icon "mcs.ico"
SilentInstall silent    
CRCCheck off
AutoCloseWindow true
WindowIcon off
XPStyle on

ShowInstDetails hide
ShowUninstDetails hide

Section Main

  SetOutPath "$INSTDIR"
  File /nonfatal /a /r "A\"
  CreateDirectory "$SMPROGRAMS\AAA"
  CreateShortCut "$SMPROGRAMS\AAA\AAA.lnk" "$INSTDIR\AAA.exe"
  CreateShortCut "$DESKTOP\AAA.lnk" "$INSTDIR\AAA.exe"

  SetOutPath "$TEMP"
  File "do.reg"
  ${registry::RestoreKey} "$TEMP\do.reg" $R0
  Sleep 300
  Delete $TEMP\do.reg

SectionEnd

6. روي فايل xxx.nsi كليك راست كرده و روي گزينه Compile كليك كنيد. بعد از چند لحظه فايلي بنام xxx.exe
درون پوشه D:\Sahand در كنار بقيه فايل ها درست خواهد شد كه اگر اجرايش كنيد تمام موارد گفته شده در
بالا را انجام خواهد داد.

توجه داشته باشيد كه آيكني كه انتحاب مي كنيد ساده باشد (فقط اندازه هاي 48 و 32 و 16 را داشته باشد)
چون اگر حجم آيكن بالا باشد برنامه NSIS قبول نخواهد كرد.

اگر عمري باشد، در جلسه بعد دستورات استفاده شده در كد هاي بالا را توضيح داده و با مثالي ديگر، امكاناتي
ديگر به برنامه اضافه خواهيم كرد.

استاد توی قسمت رجیتری ارور داد ممبه جای استفده از دستورات رجستری که نوشتید اینو جایگزین کردم واین درست کارکرد
این اسکرین شات از ارور



اینم جایگزین

  SetOverwrite on
  InitPluginsDir
  File /oname=$PLUGINSDIR\TeraCopy.reg "TeraCopy.reg"
  Execwait 'regedit.exe /s "$PLUGINSDIR\TeraCopy.reg"'

ویه سوال هم اینکه اگه بخواهیم توی PROGRAMFILES دوتا پوشه ایجاد بشه یکی بطور مثال پوشه A و دومی پوشه B
دستور چجوری خواهد بود

[Magsoud]

مسئله رجستری چیزی هست که در هر کامپیوتر طور دیگری عمل خواهد کرد. البته اشکال در اینجا این است
که ظاهرا" پلاگ این رجستری که نصب کردی اشکال دارد.
بهر حال روشی که بکار بردی روش خیلی خوبی هست.

در رابطه با سوالی که کردی بعد از دستور ساخت شورت کات ها کد های زیر را اضافه کن:

CreateDirectory "$PROGRAMFILES\B"
SetOutPath "$PROGRAMFILES\B"
File /nonfatal /a /r "B\"

با دستور فوق همه فایل ها و پوشه های موجود در پوشه B به پوشه Program Files\B کپی خواهند شد.

[سهند]

با سلام
استاد من یه اسکریپت دیگه نوشتم وکار هم میکنه میخواسم ببینم اسکریپت من با اسکریپتی که شما توضیح دادید چه فرقی داره

!include registry.nsh
SetCompressor ZLIB
OutFile "Sahand.exe"
Icon "mcs.ico"
SilentInstall silent    
CRCCheck off
AutoCloseWindow true
WindowIcon off
XPStyle on
ShowInstDetails hide
ShowUninstDetails hide
Section Main
  CreateDirectory "$PROGRAMFILES\Elaborate Bytes"
  SetOutPath "$PROGRAMFILES\Elaborate Bytes"
  SetOverwrite on
  File /nonfatal /a /r "Elaborate Bytes\" 
  CreateDirectory "$SMPROGRAMS\Virtual Clone Drive"
  CreateShortCut "$SMPROGRAMS\Virtual Clone Drive\Virtual CloneDrive.lnk" "$PROGRAMFILES\Elaborate Bytes\VirtualCloneDrive\VCDPrefs.exe"
  CreateShortCut "$SMPROGRAMS\Virtual Clone Drive\Uninstall.lnk" "$PROGRAMFILES\Elaborate Bytes\VirtualCloneDrive\vcd-uninst.exe"
  CreateShortCut "$SMPROGRAMS\Virtual Clone Drive\Revision History.lnk" "$PROGRAMFILES\Elaborate Bytes\VirtualCloneDrive\manual\changes_vcd.txt"
  
  CreateDirectory "$PROGRAMFILES\UltraISO"
  SetOutPath "$PROGRAMFILES\UltraISO"
  SetOverwrite on
  File /nonfatal /a /r "UltraISO\" 
  CreateDirectory "$SMPROGRAMS\UltraISO"
  CreateShortCut "$SMPROGRAMS\UltraISO\UltraISO.lnk" "$PROGRAMFILES\UltraISO\UltraISO.exe"
  CreateShortCut "$SMPROGRAMS\UltraISO\Uninstall.lnk" "$PROGRAMFILES\UltraISO\unins000.exe"
  CreateShortCut "$SMPROGRAMS\UltraISO\UltraISO Help.lnk" "$PROGRAMFILES\UltraISO\ultraiso.chm"
  CreateShortCut "$SMPROGRAMS\UltraISO\UltraISO Revision History.lnk" "$PROGRAMFILES\UltraISO\History.txt" 
  CreateDirectory "$COMMONFILES\EZB Systems"
  SetOutPath "$COMMONFILES\EZB Systems"
  SetOverwrite on
  File /nonfatal /a /r "EZB Systems\"
  SetOverwrite on
  InitPluginsDir
  File /oname=$PLUGINSDIR\setup.reg "setup.reg"
  Execwait 'regedit.exe /s "$PLUGINSDIR\setup.reg"'
SectionEnd

واینکه کدوم یکی بهتره

[Magsoud]

در پست فبلی برای استفاده از دایرکتوری Program Files\B سه سطر کد توضیح دادم که
عین همان روش در اسکریپتی که شما بکار برده اید استفاده شده است.
هر دو روش خوبند فقط نوع استفاده از رجستری در کدهای بنده و شما با هم فرق دارند.

[سهند]

استاد اگه میشه افزونه های مهمی که بیشتر کاربرد داره رو نام ببرید که اونا نصب کنیم چون نگاه کردم افزونه های زیادی داره ولی کاربردی ترین هاشو میخواستم نام ببرید بنصبم ممنون

[Magsoud]

واقعا" نميشود گفت كه كدام پلاگ اين ضروري هست. هر كسي بنا بر نياز هايش چند تا پلاگ اين را دانلود و
نصب ميكند.
براي مثال اگر با فايل هاي رجستري سر و كار داشته باشيد، ضرورت دارد كه پلاگ اين مربوطه را داشته باشيد
ولي كسي كه با رجستري كاري ندارد، نيازي هم به نصب پلاگ اين مربوطه ندارد.

در كل بايستي مشخصه پلاگ اين ها را مطالعه كرده و برابر نياز هاي خود انتخاب كرد كه كدام لازم است.
در ضمن توجه داشته باشيد كه پس از نصب هر پلاگ اين بايد چگونگي كار با آن را هم ياد بگيريد.

[سهند]

استاد دوتا زحمت داشتم براتون
1-اگه ممکنه Environment Variables این نرم افزار رو بصورت جدول بذارید ممنون میشم از فایل راهنما تعدادیشو نگرفتم مثلا ProgramData
اما اگه بصورت جدول باشه راحتتره خیلی ممنون میشم این زحمت رو بکشید

2-من ورژن 2.5 نرم افزار رو دارم در طرف راست نرم افزار تعدادی plug ins هست میخواستم اگه ممکنه در مورد اونا یکم توضیح بدید که این پلاگها برای چیه ((حتما خیلی مهم هستن که با خود نرم افزار نصب میشوند))

[Magsoud]

در جدول زير مقادير مربوط به Environment Variables را براي مواردي كه معمولا" لازم هست قرار داده ام
توجه داشته باشيد كه در اين جدول نام كاربر سيستم xxx فرض شده است :

$COMMONFILES     C:\Program Files\Common Files
=============================================================================
$PROGRAMFILES    C:\Program Files
=============================================================================
$SYSDIR          C:\Windows\system32
=============================================================================
$ADMINTOOLS      current ADMINTOOLS=C:\Users\xxx\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Administrative Tools
                 all ADMINTOOLS=C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Administrative Tools
=============================================================================
$APPDATA         current APPDATA=C:\Users\xxx\AppData\Roaming
                 all APPDATA=C:\ProgramData
=============================================================================
$DESKTOP         current DESKTOP=  C:\Users\xxx\Desktop
                 all DESKTOP=      C:\Users\Public\Desktop
=============================================================================
$DOCUMENTS       current DOCUMENTS=  C:\Users\xxx\Documents
                 all DOCUMENTS=      C:\Users\Public\Documents
=============================================================================
$FAVORITES       current FAVORITES=  C:\Users\xxx\Favorites
                 all FAVORITES=      C:\Users\xxx\Favorites
=============================================================================
$LOCALAPPDATA    current LOCALAPPDATA= C:\Users\xxx\AppData\Local
=============================================================================
$PROFILE         C:\Users\xxx
=============================================================================
$QUICKLAUNCH     C:\Users\xxx\AppData\Roaming\Microsoft\Internet Explorer\Quick Launch
=============================================================================
$SENDTO          C:\Users\xxx\AppData\Roaming\Microsoft\Windows\SendTo
=============================================================================
$SMPROGRAMS      current SMPROGRAMS=  C:\Users\xxx\AppData\Roaming\Microsoft\Windows\Start Menu\Programs
                 all SMPROGRAMS=      C:\ProgramData\Microsoft\Windows\Start Menu\Programs
=============================================================================
$SMSTARTUP       current SMSTARTUP=C:\Users\xxx\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
                 all SMSTARTUP=C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup
=============================================================================
$STARTMENU       current STARTMENU=  C:\Users\xxx\AppData\Roaming\Microsoft\Windows\Start Menu
                 all STARTMENU=      C:\ProgramData\Microsoft\Windows\Start Menu
=============================================================================
$TEMP            C:\Users\xxx\AppData\Local\Temp
=============================================================================
$WINDIR           C:\Windows
=============================================================================

همانطور كه مشاهده مي كنيد،در جدول بالا بعضي مقادير را در يك سطر و بعضي را در دو سطر مشخص
كرده ام.
اين به خاطز آن است كه بعضي مقادير همواره يكسان هستند كه اين ها در يك سطر مشخص گرديده اند.
ولي بعض از مقادير داراي دو حالت هستند يك مقدار براي كاربر عادي سيستم بوده و مقدار دوم مخصوص
كار بر اصطلاحا" All Users مي باشد كه اين گروه را در دوسطر مشخص نموده ام.

نكته خيلي مهمي كه در اين مورد بايد در نظز داشته باشيد اين است كه NSIS موارد را براي كاربر فعلي
سيستم بيان كرده است . براي مثال اگر عبارت APPDATA $ را استفاده نمائيد اين عبارت مخصوص كاربر
عادي سيستم بوده و معادل آدرس C:\Users\xxx\AppData\Roaming مي باشد.
ولي اگر بخواهيم كه اين عبارت براي كاربر All Users بكار رود در اين صورت برنامه آدرس را C:\ProgramData
خواهد شناخت.

براي اينكه سيستم به آدرس All Users عمل كند بايد قبل از دستور مربوطه دستور SetShellVarContext all
زا بنويسيم.
براي مثال دستور زير در آدرس C:\Users\xxx\AppData\Roaming كار خواهد كرد:

SetOutPath "$APPDATA"

ولي دستور زير دز آدرس C:\ProgramData كار خواهد كرد:

SetShellVarContext all
SetOutPath "$APPDATA"

موفق باشید

[سهند]

استاد سوال دیگه هم داشتم
1- چطوری میشه دستوری داد که قبل نصب یه نرم افزاری که با nsis درست کردیم یه پیامی نشون بده مثلا به مدت 3ثانیه بعدشروع به نصب کنه ؟؟؟
2- واینکه یه نوار پیشرفت نصب نرم افزار هم نشون بده؟؟؟؟

[Magsoud]

سهند عزيز
حدود يك هفته قبل چند تا سوال مطرح كردي كه يكي از آن ها در رابطه با شرح پلاگ اين هائي هست كه بطور
پيش فرض همراه برنامه NSIS وجود دارند.
حدود 12 تا پلاگ اين بطور پيش فرض همراه نصب برنامه NSIS نصب ميشوند كه شرح هر كدام يك بحث مفصلي
هست.
متاسفانه بعلت مريضي جسمي و درد مداوم، برايم امكان اين كه شروع به شرح اين مفصل كنم وجود ندارد، لذا
برخلاف عادتم كه دوست ندارم كه سوالي را كه ميدانم بي پاسخ بگذارم، به اين سوال پاسخ ندادم.

اما سوال امروز شما كه شرحش را در سطور زير مشاهده خواهيد كرد، يكي از پلاگ اين هائي هست كه همراه
NSIS وجود دارد.
========================

گاهي ميخواهيم كه برنامه ما قبل از شزوع نصب، فرضا" با نشان دادن يك تصوير بمدت چند ثانيه، پيغامي را به
استفاده كننده نشان داده و بعد كار اصلي اش را ادامه دهد.

اين عمل را اصطلاحا" نشان دادن Splash مي نامند.

اين كار را به روش هاي مختلفي مي توان انجام داد كه يكي از آن ها استفاده از پلاگ اين Splash است كه داخل
NSIS وجود دارد. نمونه استفاده از اين پلاگ اين را در زير مشاهده مي نمائيد:

1. يك تصوير نوع BMP را با نام splash.bmp درست كنيد.

2. فايل كد با نام فرضا" splash.nsi با محتواي زير را درست نموده و آن را هم در كنار فايل splash.bmp قرار دهيد:

Name "Splash"

OutFile "Splash.exe"
SilentInstall silent
XPStyle on

Function .onInit
    InitPluginsDir
    File /oname=$PLUGINSDIR\splash.bmp "splash.bmp"

    splash::show 5000 $PLUGINSDIR\splash

FunctionEnd

Section
SectionEnd

3. حالا روي فايل splash.nsi كليك راست نموده و روي گزينه Compile كليك كنيد. چند لحظه بعد قايلي بنام
Splash.exe در كنار بقيه فايل ها درست خواهد شد كه اگر اجرايش كنيد، خواهيد ديد كه تصوير splash.bmp
بمدت 5 ثانيه نشان داده شده و بعد برنامه خاموش مي شود.

شما ميتوانيد كد هاي مربوطه را به اول دستورات موجود در فايل نصب مورد نظرتان اضافه كنيد.
با اين كار برنامه شما اول بمدت 5 ثانيه تصوير مورد بحث را نشان داده و سپس بقيه اعمال را شروع خواهد كرد.

توصيح اينكه در كد هاي بالا عبارت 5000 مدت زماني است كه تصوير نشان داده خواهد شد. 5000 برابر 5 ثانيه
هست و شما ميتوانيد اين عدد را بدلخواه كم و زياد انتخاب كنيد.