UniUploader:Distribution

From WoWRosterWiKi
(Difference between revisions)
Jump to: navigation, search
(New page: {{UUMenu}} There are two common ways of distributing UniUploader.<br> <br> 1. in a Zip file, with a preconfigured settings.ini/logo1/logo2 (easier method)<br> 2. as a compiled (with NSIS)...)
 
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{UUMenu}}
+
__NOEDITSECTION__
 +
{{Disclaimer}}
 +
{{MainMenu|UniUploader}}
  
 
There are two common ways of distributing UniUploader.<br>
 
There are two common ways of distributing UniUploader.<br>
 
<br>
 
<br>
1. in a Zip file, with a preconfigured settings.ini/logo1/logo2 (easier method)<br>
+
# in a Zip file, with a pre-configured settings.ini/logo1/logo2 (easier method)
2. as a compiled (with NSIS) installer (recommended method)<br>
+
# as a compiled (with NSIS) installer (recommended method)
 
<br>
 
<br>
 
This article will explain how to package UU in a zip file as above, and how to compile a pre configured installer using NSIS.<br>
 
This article will explain how to package UU in a zip file as above, and how to compile a pre configured installer using NSIS.<br>
 
<br>
 
<br>
Your "target audience" is whoever is going to be using your UU distribution package.
+
Compiling from source is recommended if you wish to learn or already know C#.<br>
As with either method, you first must set up UU the way you want your target audience's UU to be set up. If you are using UA, it is very important to set the synchro URL and checkmarks in the update tab correctly.  Once you have set UU up the way you want, do your users a favor and switch back to simple mode.  Exit UU and navigate windows explorer to the folder containing UniUploader.exe and settings.ini.  If you want any custom images to show up in UU, save them as logo1.gif and logo2.gif in that folder (logo1.gif 216x144, logo2.gif 320x176).  Open settings.ini and remove the following lines from it:<br>
+
 
<br>
 
<br>
FILELOCATION<br>
+
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:<br>
EXELOC<br>
+
SELECTEDACCT<br>
+
 
<br>
 
<br>
because obviously they could/should be different for each user.  Uu will repopulate the 3 missing settings when the new users use it.<br>
+
* FILELOCATION
 +
* EXELOC
 +
* SELECTEDACCT
 
<br>
 
<br>
This folder and its files are what we will use for both methods.  In order to do method one simply zip up the contents and your done.<br>
+
because they could/should be different for each user.  UU will repopulate the 3 missing settings when the new users use it.<br>
 +
<br>
 +
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.<br>
 
<br>
 
<br>
 
Method 2:<br>
 
Method 2:<br>
Line 23: Line 26:
 
<br>Download the NSIS script for UU located at the UU download area at www.wowroster.net<br>
 
<br>Download the NSIS script for UU located at the UU download area at www.wowroster.net<br>
 
<br>
 
<br>
Extract the NSIS script zip file, and copy the NSIS file from it to your main UU folder (the one you set up above)
+
Extract the NSIS script zip file, and copy the NSIS file from it to your working folder.  Edit the NSIS file:<br>
edit the NSIS file:<br>
+
 
<br>
 
<br>
 
FIND:<br>
 
FIND:<br>
Line 37: Line 39:
 
Save the file, and exit the editor.<br>
 
Save the file, and exit the editor.<br>
 
<br>
 
<br>
Right click the NSIS file and click "compile NSIS script", and the NSIS engine will run and compile your shiny new custom installer for you!<br>
+
Right click the NSIS file and click "compile NSIS script", and the NSIS engine will compile your new shiny custom installer!<br>
 
<br>
 
<br>
The file "UniUploader_vX.X.X_Installer.exe" will be in the folder with the NSIS script.  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!"
+
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!"
 
+
{{Disclaimer}}
+

Latest revision as of 21:06, 17 September 2008

WR.net

Important note: When you edit this page, you agree to release your contribution into the public domain.
If you do not want this or can not do this because of license restrictions, please do not edit.

Contents


There are two common ways of distributing UniUploader.

  1. in a Zip file, with a pre-configured settings.ini/logo1/logo2 (easier method)
  2. 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:


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!"

Personal tools
Namespaces
Variants
Actions
WoWRoster
Preview Roster
Navigation
Toolbox