Wikipedia:AutoWikiBrowser/Sources

From Wikipedia, the free encyclopedia
Jump to: navigation, search

AutoWikiBrowser is licensed under the GPL (see the license file).

.NET[edit]

AutoWikiBrowser is written in .NET. Version 3.5 or earlier is required to compile AWB. .NET 3.0 is included on Windows Vista. .Net 3.5 is included on Windows 7. .NET version 4.0 and greater will work, but will require a slight modification to AWB's code and the installation of Windows SDK for Windows 7 or Windows SDK for Windows 8.

Download source[edit]

To get the sources, you need read access to the SourceForge SVN server with an SVN client program.

  1. Download and install TortoiseSVN. It is the recommended SVN client program.
  2. Create a folder AWB (or whatever name you prefer) on your computer.
  3. Right click on the folder, and select "SVN Checkout...".
  4. In the dialog window that appears (titled "Checkout") enter http://svn.code.sf.net/p/autowikibrowser/code/AWB/ for the field URL of Repository. (This is read only access, the read-write URLs are different)
  5. Click OK

You should then get the sources from the SourceForge SVN server. This is a ~3 MB download with ~1,200 files and folders.

Please note that you cannot commit sources back to the SourceForge server by using this method (this is called "anonymous access" or "anon access" for short). You would need to be registered as a project developer for this, the sourceforge page then provides a read-write URL for you .

Compile source[edit]

You will now need to compile the code yourself. You will need a copy of a third-party C# IDE such as SharpDevelop (free), Microsoft Visual C# Express Edition (free) or a more complete version of the Visual Studio 2010 suite, such as Professional (cost).

SharpDevelop[edit]

  1. Download and install the latest version of SharpDevelop
  2. Click on File -> Open -> Project/Solution. Open the "AutoWikiBrowser no plugins" solution file.
  3. Press F8 to build AWB. The AWB executable will be placed in ...\AWB\AWB\bin\debug. Copy AutoWikiBrowser.exe, WikiFunctions.dll and Interop.mshtml.dll from the folder to where you run AWB from.

Visual Studio[edit]

  1. Download and install Visual C# Express Edition or Visual Studio 2010 suite.
  2. Browse to the second AWB folder, and run the Visual Studio Solution
  3. When the IDE has loaded, select release rather than debug (next to the green forward arrow). On the solution explorer on the right hand side, right click on the solution, and select build solution. Visual Studio will now turn the source files into the required files to run AWB.
  4. Back in the AWB folder, browse to bin\release, and copy AutoWikiBrowser.exe and WikiFunctions.dll from the folder to where you run AWB from.

.NET 4.0/4.5 error[edit]

If you get an error while compiling saying something similar to, "Error loading code-completion information for Microsoft.mshtml from Microsoft.mshtml: Could not find assembly file.", this means you do not have .NET 3.5 or earlier installed. AWB can still be compiled, but will require a slight code change. It is recommended you install .NET 3.5, but if you cannot, see the talk page for further help.

Changes to AWB code[edit]

You can view all SVN changes one of two ways:

  1. Browse Commit
  2. Right click on the folder that contains the source code, then go Tortoise SVN -> Show log.

Update code from SVN[edit]

When new sources become available execute "SVN Update" from the context menu of your AWB folder. Then recompile the source.

You are not automatically notified of new versions; if you use AWB on a regular basis, and want to use the source version, check this daily, and build a new release version if there are changes. That way you are up to date with all bug fixes and new features.