Skip to content

Commit af41cd6

Browse files
authored
Improve steamcmd macos doc (#227)
1 parent b418775 commit af41cd6

File tree

1 file changed

+8
-3
lines changed
  • docs/gdevelop5/publishing/publish-to-steam

1 file changed

+8
-3
lines changed

docs/gdevelop5/publishing/publish-to-steam/index.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,17 @@ You then configure a "Build" that is using the "depots". You can use the web int
3636

3737
![](./builds-upload-web.png)
3838

39-
### Issue when uploading a macOS build
39+
### Issue when uploading a macOS build: how to properly upload your macOS game
4040

41-
There is an issue making the macOS application not working after uploading the macOS zip file (this is because [the Steam web uploader breaks the symlinks](https://github.com/electron-userland/electron-builder/issues/5767#issuecomment-813920169)).
41+
There is an issue making the macOS application not working after uploading the macOS zip file (this is because [the Steam web uploader breaks the symlinks](https://github.com/electron-userland/electron-builder/issues/5767#issuecomment-813920169)). This results in a broken app that does not launch and crashes immediately with a message related to `Electron Framework.framework`.
4242
Instead, you must use the **steamcmd** command line tool to upload your macOS files.
4343

44-
- Start by extracting the macOS zip file somewhere. Use Linux or macOS - Windows will break the "symlinks" when extracting the zip file. Extract the files in a folder called `mac`. You should have a single folder, "Your Game.app" inside this `mac` folder.
44+
- Start by extracting the macOS zip file somewhere. Use Linux or macOS `unzip` command line tool - Windows will break the "symlinks" when extracting the zip file. Extract the files in a folder called `mac`. You should have a single folder, "Your Game.app" inside this `mac` folder.
45+
46+
!!! danger
47+
48+
Windows, and some archiver softwares on Linux, will break the "symlinks" when extracting the zip file - making it impossible to run the app. Use `unzip` on macOS or Linux.
49+
4550
- Create a [Build Config file](https://partner.steamgames.com/doc/sdk/uploading) called `steam-upload-config.vdf`. Put it next to the folder called `mac`. This is an example:
4651

4752
```

0 commit comments

Comments
 (0)