|T O P I C R E V I E W
||Posted - 01/07/2013 : 11:53:16
Beginning with 2.5.6+, here is how S+ will behave regarding the location of user files (StrokesPlus.xml, StrokesPlus.lua, Language.xml, ActionHelp.xml).
If a custom config path is supplied, S+ will behave exactly as it has (except for the ActionHelp.xml location change noted below). User files will attempt to be loaded from the directory of the custom config file; failure to load/write will result in an error and S+ will exit.
Note that ActionHelp.xml is now loaded from the user files location as well, previously it was loaded from the S+ install directory.
If S+ is run without a custom config file:
1. Attempt to load the user files from the same directory from which S+ is running.
2. If StrokesPlus.xml doesn't exist in the StrokesPlus.exe folder OR the file cannot be opened with read/write privileges, use the following folder: %APPDATA%%\StrokesPlus\ (e.g. C:\Users\Rob\AppData\Roaming\StrokesPlus)
This means that S+ can be run in portable mode so long as S+ has read/write privileges in the directory from which S+ is being opened; if not, %APPDATA% will be used. The installers now place the user files under %APPDATA% instead of the S+ install directory. This means that you may have a confusing situation if the user files exist in the install directory and the installer creates copies under %APPDATA%. Just remember the rules, if S+ can read/write to the user files in the S+ install directory, they will be used; otherwise the files in %APPDATA% will be loaded.
IMPORTANT: If you previously ran S+ without admin privileges from the Program Files directory under Vista/7, you will need to remove the redirected files under C:\Users\USERNAME\AppData\Local\VirtualStore\Program Files\StrokesPlus (or something similar). Note that you should simply move these files to the %APPDATA%\StrokesPlus folder as it may have your latest settings. If you run S+ from Program Files on Vista/7 and these files exist under the VirtualStore folder, you will have problems.
I highly recommend you backup the StrokesPlus.xml file under Program Files\StrokesPlus, %APPDATA%\StrokesPlus, and/or the VirtualStore folder mentioned above before doing anything to ensure you have your latest StrokesPlus.xml (settings) file. Once you've backed up your config files, I'd recommend uninstalling S+ and deleting any files under %APPDATA%\StrokesPlus, Program Files\StrokesPlus, and/or the VirtualStore\Program Files\StrokesPlus folder. Then install the appropriate version. Once this is done, future installs will be consistent and upgrade smoothly.
If you run the portable version anywhere, make sure it's from a directory which S+ can write to, or that you run S+ as Administrator if it's a protected folder.
If you use the signed version of S+ on Windows Vista/7/8, it is recommended that you install to Program Files\StrokesPlus and move your user files to %APPDATA%\StrokesPlus. This will allow you to run S+ without administrator privileges and still have access to S+ interacting with Windows 8 screens and programs running in Administrator mode.
Basically, if you start S+ and get an error that ActionHelp.xml couldn't be loaded/parsed, it means one of the above situations exist and you need to remove the old files to get things in sync. Also, S+ will likely crash if you try to open the settings window after seeing that error. Just right-click the tray icon and click Exit; backup your files and remove the above file locations listed above and re-install. Then move your user files to the %APPDATA%\StrokesPlus folder.
I'm sure I haven't covered all scenarios properly and there will be a period of adjustment to the new mode of operation.