Difference between revisions of "Build from source code"

From IceChat Wiki
Jump to: navigation, search
m (added link to ms.net 4.5)
(Tree structure of the source was modified)
Line 5: Line 5:
 
Download the latest source code from the page, by clicking on the <em>Download Zip</em> button.
 
Download the latest source code from the page, by clicking on the <em>Download Zip</em> button.
  
Unzip the file into any folder, for example a dedicated "C:\IceChatBuild". It is best not to use the <span class="plainlinks">[https://en.wikipedia.org/wiki/Environment_variable#Default_values %CommonProgramFiles%]</span>, because of permissions issues.
+
Unzip the file into any folder, for example a dedicated "C:\IceChatBuild". It is best not to use the <span class="plainlinks">[https://en.wikipedia.org/wiki/Environment_variable#Default_values %CommonProgramFiles%]</span>, because of permissions possible limitations.
 +
 
 +
The source tree has several text files in its root folder, a <em>build</em> folder and a <em>src</em>, where the actual code and resources are located in several sub-folders. <br />
  
 
There are several build options in the extracted root folder.
 
There are several build options in the extracted root folder.
Line 25: Line 27:
 
     0 Error(s)
 
     0 Error(s)
  
Time Elapsed 00:00:00.35
+
Time Elapsed 00:00:00.32
.\bin\Debug\IceChat2009.exe
+
..\src\IceChat\bin\Debug\IceChat2009.exe
 
1 File(s) copied
 
1 File(s) copied
.\bin\Debug\IPluginIceChat.dll
+
..\src\IceChat\\bin\Debug\IPluginIceChat.dll
 
1 File(s) copied
 
1 File(s) copied
.\bin\Debug\IRCConnection.dll
+
..\src\IceChat\\bin\Debug\IRCConnection.dll
 
1 File(s) copied
 
1 File(s) copied
.\bin\Debug\IThemeIceChat.dll
+
..\src\IceChat\\bin\Debug\IThemeIceChat.dll
 
1 File(s) copied
 
1 File(s) copied
 
IceChat files copied to the IceChatBuild folder
 
IceChat files copied to the IceChatBuild folder
Line 38: Line 40:
 
</pre>
 
</pre>
  
A new folder is created called <em>IceChatBuild</em>, and once the batch file has completed, 5 files will be placed in this folder.
+
A new folder is created called <em>IceChatBuild</em>, and once the batch file has completed, 4 files will be placed in this folder.<br />
 +
A log file named <code>Manual_MSBuild_ReleaseVersion_LOG.log</code> is also created.
  
Copy these 5 files into your <em>IceChat</em> installation folder, or place them anywhere else you want.
+
Copy these 4 files into your <em>IceChat</em> installation folder, or place them anywhere else you want.
  
To see all the changes from build to build, read the <em>changelog.txt</em> file in the source code.
+
To see all the changes from build to build, read the <em>changelog.txt</em> file in the root folder.
 
==Troubleshooting==
 
==Troubleshooting==
 
<p>
 
<p>

Revision as of 10:14, 19 June 2016

IceChat 9 is an open source program, which means the source code is available to anyone.

The source code is updated more often then the full installs/updates and is located at https://github.com/icechat/IceChat

Download the latest source code from the page, by clicking on the Download Zip button.

Unzip the file into any folder, for example a dedicated "C:\IceChatBuild". It is best not to use the %CommonProgramFiles%, because of permissions possible limitations.

The source tree has several text files in its root folder, a build folder and a src, where the actual code and resources are located in several sub-folders.

There are several build options in the extracted root folder.

BuildIceChat.cmd
which uses .NET 3.5, and should be used by XP users
BuildIceChat-x86.cmd
which uses .NET 3.5 and a specific project for x86 computers. This too can be used by XP users.
BuildIceChat.4.5.cmd
which uses .NET 4.5.
BuildIceChat.4.5-x86.cmd
which uses .NET 4.5 and a specific project for x86 computers.

If you are not sure which version to choose, and your OS is later then XP, use the BuildIceChat.4.5.cmd.

You can either double click on the BuildIceChat.4.5.cmd file or open a command line window (cmd.exe) and run the BuildIceChat.4.5.cmd at the prompt.

You will get at the end of the process the following lines:

    0 Error(s)

Time Elapsed 00:00:00.32
..\src\IceChat\bin\Debug\IceChat2009.exe
1 File(s) copied
..\src\IceChat\\bin\Debug\IPluginIceChat.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IRCConnection.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IThemeIceChat.dll
1 File(s) copied
IceChat files copied to the IceChatBuild folder
Press any key to continue . . .

A new folder is created called IceChatBuild, and once the batch file has completed, 4 files will be placed in this folder.
A log file named Manual_MSBuild_ReleaseVersion_LOG.log is also created.

Copy these 4 files into your IceChat installation folder, or place them anywhere else you want.

To see all the changes from build to build, read the changelog.txt file in the root folder.

Troubleshooting

If the BuildIceChat.cmd returns errors, try instead to run the newer IceChatBuild.4.5.cmd which was specifically created for users who have errors with IceChatBuild.cmd.

If you experience problems connecting to servers with SSL, try build with IceChatBuild.4.5.cmd

Sources

Get Microsoft .NET Framework 4.5.2 at this link.