yizhi-js-lib/favicon-trap
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added samples projects for MSVC binding.

Browse Source 
Added MSVC support to unicorn samples.
This commit is contained in:
xorstream
2015-12-08 18:21:32 +11:00
parent c08fa22550
commit c5c13e110a
20 changed files with 1199 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

118
bindings/msvc/README.TXT
View File

@ -1,3 +1,7 @@
:: Overview
This documentation explains how to use Unicorn with Microsoft Visual C++ (MSVC).
This will not build the Unicorn Engine itself, it just allows you to use the
prebuilt Windows binaries when writing projects in Microsoft Visual C++.
@ -8,17 +12,19 @@ heading on the following page. Be sure to use the 32bit package when making
build 64bit applications.
http://www.unicorn-engine.org/download/
It is not possible to use the prebuilt static Unicorn library, unicorn.lib,
It is not possible to use the prebuilt static Unicorn library "unicorn.lib"
with Microsoft Visual C++ because it will complain about a bunch of missing
functions, variables etc.
We therefore use the prebuilt dynamic Unicorn library, unicorn.dll.
We therefore use the prebuilt dynamic Unicorn library "unicorn.dll".
There are two ways to use this with your Microsoft Visual C++ project:
1) By dynamically linking the dll into your project.
2) By statically linking the dll into your project.
There are pre-prepared sample projects that use each method, but in the event
you wish to set up your own projects there are details to do so below.
:: 1) Dynamic Linking
@ -49,6 +55,7 @@ Now build your application as normal.
:: 2) Static Linking
To perform static linking of unicorn.dll, you need to first generate some
@ -75,3 +82,106 @@ Or by adding "unicorn_staload.lib" to your project in:
Configuration Properties -> C/C++ -> Linker -> Input -> Additional Dependencies
:: Notes about Visual Studio versions.
These solution and project files were created using Visual Studio 2012.
They should be able to be opened in newer versions of Visual Studio.
For older versions of Visual Studio you could try a little hack of changing
the line in the solution file "samples.sln" from:
Microsoft Visual Studio Solution File, Format Version 12.00
to
Microsoft Visual Studio Solution File, Format Version 11.00
Or whatever version number your Visual Studio version uses.
(Hint: Check an existing solution file you have created with your version
of Visual Studio to know what this value is expected to be.)
Also note that all instructions below are for Visual Studio 2012. So if you
are using a different version then the settings may be located in different
areas or have different names.
:: Building the pre-prepared sample projects
Some sample projects have been included in the bindings\msvc\samples directory.
The solution file in this directory is "samples.sln".
This was created with Visual Studio 2012 and once opened contains 2 projects
"dynload" and "staload".
The "dynload" project is an example of a project that uses dynamic linking.
The "satload" project is an example of a project that uses static linking.
Both projects have 32bit (win32) and 64bit (x64) target platforms.
The 32bit platform (win32) will create a 32bit app that can run on either
32bit or 64bit Windows. The 64bit platform (x64) can only run on 64bit Windows.
All variants can be built at once by using the batch build function:
Go to "Build -> Batch Build" and tick all checkboxes, or at least the ones
that you wish to build. Then click on the Build or Rebuild button.
Note that when building the "staload" projects you must first have built
the static import libraries as mentioned above.
:: Running the pre-prepared sample projects
When running the samples they will need to be able to load the unicorn dlls.
The unicorn dlls required for 32bit apps are:
libgcc_s_dw2-1.dll
libglib-2.0-0.dll
libiconv-2.dll
libintl-8.dll
libwinpthread-1.dll
unicorn.dll
The unicorn dlls required for 64bit apps are:
libgcc_s_seh-1.dll
libglib-2.0-0.dll
libiconv-2.dll
libintl-8.dll
libwinpthread-1.dll
unicorn.dll
Note that while some of the 32bit and 64bit dlls have the same filename,
they are internally different in that they are either 32bit or 64bit files
themselves. So you will have to have separate directories to store them in.
I suggest using directory names such as "unicorn32" and "unicorn64" when
installing the prebuilt windows binaries. This will make it easy to
differentiate between them.
If running the sample exe files from the command line or from Windows Explorer
then you need ensure that the exe file is in the same directory as either the
32bit or 64bit set of dlls.
To run the samples from inside Visual Studio so that you can debug them or just
easily test various changes you should set the working directory to point to a
directory that contains all of the dlls. Assuming you are running a 32bit app
and have the 32bit unicorn dlls in the directory "C:\unicorn32" then do:
1) Go to the Solution Explorer window in Visual Studio.
You can use "View -> Solution Explorer" to get to it.
2) Highlight one or more projects that you want to run/debu from in
Visual Studio. Use hold control when selecting to select multiples,
or hold Shift to select ranges of projects.
3) Right click on the selected projects and go to Properties.
4) Now go to "Configuration Properties -> Debugging -> Working Directory".
Change the value for this to "C:\unicorn32".
You will need to change this for both Debug and Release configurations.
You can change between configurations on the top left of the Property Pages
dialog box that you are currently on.
6) Click OK when done and then you are ready to run or debug the projects.
Do "Debug -> Start Debugging" or press F5 to debug the current project.
Do "Debug -> Start Without Debugging" or press Ctrl+F5 to run the current project.
You can change the current project by right clicking on a project in
Solution Explorer and selecting "Set as StartUp Project"