123 lines
3.6 KiB
Plaintext
123 lines
3.6 KiB
Plaintext
How To Compile/Build AppleWin
|
|
=============================
|
|
|
|
MSVC 2017 Community
|
|
===================
|
|
|
|
1. Install [.NET Framework 4.6](https://www.microsoft.com/en-us/download/details.aspx?id=48137)
|
|
|
|
NOTE: The installer _will still_ complain about 4.6 even if [4.6.2](http://www.microsoft.com/en-us/download/details.aspx?id=53344) is installed.
|
|
)
|
|
|
|
2. MSVC 2017 Community Edition
|
|
|
|
a. Install [MSVC 2017 Community](https://www.visualstudio.com/thank-you-downloading-visual-studio/?sku=Community&rel=15)
|
|
b. Run `vs_Community.exe`
|
|
c. `Individual Components`
|
|
|
|
NOTE: Not all of these may be required but they are recommended:
|
|
|
|
|
|
* [x] .NET Framework 4.6.1 SDK
|
|
* [x] .NET Framework 4.6.1 targeting pack
|
|
* [x] C++ profiling tools
|
|
* [x] C++/CLI support
|
|
* [x] Git for Windows
|
|
* [x] Graphics Tools Windows 8.1 SDK
|
|
* [x] Graphics debugger and GPU profiler for DirectX
|
|
* [x] Static analysis tools
|
|
* [x] VC++ 2017 v141 toolset (x86,x64)
|
|
* [x] Windows Universal CRT SDK
|
|
* [x] Visual Studio C++ core features
|
|
* [x] Windows 8.1 SDK
|
|
* [x] Windows 10 SDK (10.0.15063.0) for Desktop C++ x86 and x64
|
|
* [x] Windows 10 SDK (10.0.15063.0) for UWP: C#, VB, JS
|
|
* [x] Windows 10 SDK (10.0.15063.0) for UWP: C++
|
|
|
|
3. Clone the repository
|
|
|
|
git clone https://github.com/AppleWin/AppleWin.git
|
|
|
|
Older MSVC instructions
|
|
=======================
|
|
|
|
0. Install git
|
|
|
|
1. Clone the repository
|
|
|
|
git clone https://github.com/AppleWin/AppleWin.git
|
|
|
|
2. Download the Feb 2010 DirectX SDK
|
|
(It is the last version to have DirectDraw)
|
|
|
|
http://www.microsoft.com/en-us/download/details.aspx?id=10084
|
|
|
|
3. Add ddraw.lib to the linker include path:
|
|
|
|
AppleWin project, Right-Click Properties, Linker, General, Additional Library Directories
|
|
|
|
The default path is:
|
|
C:\Program Files (x86)\Microsoft DirectX SDK (February 2010)\Lib\x86
|
|
|
|
|
|
|
|
|
|
How to do a Coverity Scan of AppleWin
|
|
=====================================
|
|
|
|
1. Download Coverity Scan Self-Build:
|
|
https://scan.coverity.com/download?tab=cxx
|
|
|
|
Unzip and add the bin directory to your path
|
|
|
|
2. Launch VS2008 Express / Professional
|
|
|
|
3. Tools -> Visual Studio 2008 Command Prompt
|
|
|
|
VS 2008 Express:
|
|
----------------
|
|
|
|
4. Set env vars:
|
|
set include=%include%;<DirectX SDK 9.0 SDK include path>
|
|
set lib=%lib%;<DirectX SDK 9.0 SDK lib path>
|
|
|
|
EG:
|
|
set include=%include%;C:\Program Files (x86)\Microsoft DirectX SDK (February 2010)\Include
|
|
set lib=%lib%;C:\Program Files (x86)\Microsoft DirectX SDK (February 2010)\Lib\x86
|
|
|
|
5. Clean & build:
|
|
vcbuild /clean AppleWinExpress2008.sln "Release|Win32"
|
|
cov-build --dir cov-int vcbuild /u AppleWinExpress2008.sln "Release|Win32"
|
|
|
|
VS 2008 Professional:
|
|
---------------------
|
|
|
|
4. Set env vars:
|
|
N/A
|
|
|
|
5. Clean & build:
|
|
devenv AppleWinExpress2008.sln /clean
|
|
cov-build --dir cov-int devenv AppleWinExpress2008.sln /build release
|
|
|
|
|
|
|
|
|
|
How to disable F12 so it doesn't trigger a breakpoint
|
|
=====================================================
|
|
|
|
When running AppleWin from Visual Studio (eg. F5), then F12 will trigger a breakpoint.
|
|
|
|
This is undesirable, since F12 is used to load a save-state.
|
|
|
|
AppleWin does also support CTRL+F12 to load a save-state too (for this very reason), but it's possible to disable F12 triggering the breakpoint.
|
|
|
|
Background:
|
|
F12 is the OS's default UserDebuggerHotKey:
|
|
https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2003/cc786263(v=ws.10)
|
|
|
|
Fix:
|
|
. Change this Registry key: "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug" -> UserDebuggerHotKey to 0x07 (*)
|
|
. And restart the PC for it to take effect.
|
|
|
|
(*) Where 0x07 = Undefined
|
|
(See: https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes) |