Skip to content

Commit

Permalink
Cleanup: Remove MSBuild / SLN
Browse files Browse the repository at this point in the history
Resolve #89

Update README and gitignore; Commit custom debug build paths for CMake
VS
  • Loading branch information
dreamsyntax committed Jan 20, 2025
1 parent b6e7f79 commit 4e64704
Show file tree
Hide file tree
Showing 6 changed files with 28 additions and 214 deletions.
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ Source/bin/
Source/obj/
Source/GeneratedFiles/
Source/cmake-build-debug/*
Source/out/
Source/*.ipch
Source/*.opensdf
Source/*.sdf
Expand All @@ -17,4 +18,6 @@ Source/.vs/
Source/.vscode/
.vscode/
.idea/*
.DS_Store
.DS_Store
.vs/
.vscode/
17 changes: 9 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ For binary releases of this program, refer to [the "releases" page](https://gith
## System requirements
Any x86_64 based system should work.

This repository uses CMake for all platforms.

At least 250 MB of free memory is required.

You need to have Dolphin running ***and*** _have the emulation started_ for this program to be useful. As such, the system must meet Dolphin's [system requirements](https://github.com/dolphin-emu/dolphin#system-requirements).
Expand All @@ -39,15 +41,14 @@ Create a empty file `portable.txt` in the same directory as Dolphin Memory Engin

## How to Build
### Microsoft Windows
This repository provides a solution file for Visual Studio 2022 and later. The Windows SDK Version 10.0.22621.0 is required*.
Visual Studio 2022 and later is recommended. The Windows SDK Version 10.0.22621.0 is required.

Before proceeding, ensure the Qt submodule is initialized by running `git submodule update --init` at the repository's root. The files should appear at the `Externals\Qt` directory.

Once complete, open the solution file `dolphin-memory-engine.sln` located in the `Source` directory with Visual Studio. Select the build configuration and build it.
Once complete, open the `Source` directory with Visual Studio's `Open a local folder` option.

#### Windows SDK
The Windows SDK version 10.0.22621.0 comes with the C++ Desktop Development Workload of Visual Studio 2022 — other versions may work but are untested. To use a different Windows SDK you'll need to select it in the project properties window. Please note that this will change the `vcxproj` file, so if you plan to submit a Pull Request, make sure to not stage this change.

The Windows SDK version 10.0.22621.0 comes with the C++ Desktop Development Workload of Visual Studio 2022 — other versions may work but are untested.

### Linux
> _CMake and Qt 6 are required. Please refer to your distribution's documentation for specific instructions on how to install them._
Expand Down Expand Up @@ -117,15 +118,15 @@ Options:

## Troubleshooting

On Linux, the program may require additional kernel permissions to be able to read and write memory to external processes (which is required to read and write the memory of Dolphin). If nothing happens to Dolphin, but the program frequently unhooks itself, the program is missing the required permissions. Grant these permissions by running the following command as root:
On Linux, the program may require additional kernel permissions to be able to read and write memory to external processes (which is required to read and write the memory of Dolphin). If nothing happens to Dolphin, but the program frequently unhooks itself, the program is missing the required permissions. Grant these permissions by running the following command as root:

setcap cap_sys_ptrace=eip DME
setcap cap_sys_ptrace=eip dolphin-memory-engine

Where `DME` is the path of the Dolphin Memory Engine executable. This should fix the permission problem for future executions.
Where `dolphin-memory-engine` is the path of the Dolphin Memory Engine executable. This sets the permission for future executions.

If it doesn't work, verify that you do not have the `nosuid` mount flag on your `/etc/fstab` as it can cause this command to silently fail.

On macOS, Dolphin (upon install or after an update) must be signed with specific entitlements to permit memory access. Follow the instructions [above](#macos-code-signing).

## License
This program is licensed under the MIT license which grants you the permission to do anything you wish to with the software, as long as you preserve all copyright notices. (See the file LICENSE for the legal text.)
This program is licensed under the MIT license which grants you the permission to do anything you wish to with the software, as long as you preserve all copyright notices. See the file LICENSE for the legal text.
15 changes: 15 additions & 0 deletions Source/CMakeSettings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"configurations": [
{
"name": "x64-Debug",
"generator": "Ninja",
"configurationType": "Debug",
"inheritEnvironments": [ "msvc_x64_x64" ],
"buildRoot": "${projectDir}\\bin\\build\\${name}",
"installRoot": "${projectDir}\\bin\\install\\${name}",
"cmakeCommandArgs": "",
"buildCommandArgs": "",
"ctestCommandArgs": ""
}
]
}
25 changes: 0 additions & 25 deletions Source/dolphin-memory-engine.default.props

This file was deleted.

25 changes: 0 additions & 25 deletions Source/dolphin-memory-engine.sln

This file was deleted.

155 changes: 0 additions & 155 deletions Source/dolphin-memory-engine.vcxproj

This file was deleted.

0 comments on commit 4e64704

Please sign in to comment.