UniUploader:Distribution
Important note: When you edit this page, you agree to release your contribution into the public domain. |
Contents |
There are two common ways of distributing UniUploader.
- in a Zip file, with a pre-configured settings.ini/logo1/logo2 (easier method)
- as a compiled (with NSIS) installer (recommended method)
This article will explain how to package UU in a zip file as above, and how to compile a pre configured installer using NSIS.
Compiling from source is recommended if you wish to learn or already know C#.
Method 1 involves creating a working folder and copying various components to it, then compressing the folder into a zip/rar/etc file. Create a new folder and call it "working folder". Open UU and set it up the way you want your guildies' UU to be set up. If you're using UA, it is important to set the synchro aka. update URL. Place/Remove check marks in the update tab accordingly. Once UU is the the way you want, do your users a favor and switch back to simple mode. When UU exits it craps out a "settings.ini" file in the exe container or "%APPDATA%\wowroster.net\<version>". Exit UU and navigate windows explorer to the folder containing settings.ini and copy it to the working directory. If you want any custom images to show up in UU, save them as (logo1.gif 216x144, logo2.gif 320x176) in the workspace folder as well. Copy the compiled "UniUploader.exe" to the working directory. An icon for the system tray called systray.ico can be included in the working directory. Open settings.ini and remove the following lines:
- FILELOCATION
- EXELOC
- SELECTEDACCT
because they could/should be different for each user. UU will repopulate the 3 missing settings when the new users use it.
This working folder and its files are what we will use for both methods. In order to do method one simply zip up and distribute the working folder.
Method 2:
Go to http://nsis.sourceforge.net/Download and download the NSIS package, and install it.
Download the NSIS script for UU located at the UU download area at www.wowroster.net
Extract the NSIS script zip file, and copy the NSIS file from it to your working folder. Edit the NSIS file:
FIND:
;File "UniUploader\settings.ini"
REPLACE WITH:
File "settings.ini"
Save the file, and exit the editor.
Right click the NSIS file and click "compile NSIS script", and the NSIS engine will compile your new shiny custom installer!
The file "UniUploader_vX.X.X_Installer.exe" will be crapped into the working folder. In addition to installing UU, the installer will also check to see if the user has the Microsoft .NET Framework installed or not (any version) and if not, will prompt the user if he/she wishes to download/install it. If the user chooses not to, the installer will fail and the only thing the user can do at that point is press cancel. If the user clicks yes, the installer will download the .NET Framework 2.0 from download.microsoft.com and will install it right there on the spot. It does the .NET Framework stuff before installing UU, so no more "UU is broken because of an error 135!"