Boxedwine icon indicating copy to clipboard operation
Boxedwine copied to clipboard

Request: more documentation

Open Benman2785 opened this issue 10 months ago • 4 comments

Hi you all,

thank you for providing wasm support for wine -> my dream is to run "StarTrek - Birth of the Federation" or "Perry Rhodan: Operation Eastside" in my browser.

main problem: you say quiet nothing on how to compile and how to set up boxedwine to run anything in the browser

thank you in advance

Benman2785 avatar Feb 15 '25 09:02 Benman2785

I found steps to build for emscripten in the jenkins file.

      source ~/emsdk/emsdk_env.sh
      set -x
      rm -rf Deploy
      make
      if [ ! -f "Build/Release/boxedwine.wasm" ] 
      then
          echo "boxedwine.wasm DOES NOT exists."
          exit 999
      fi
      mkdir -p Deploy/Web
      cp Build/Release/boxedwine.html Deploy/Web
      cp boxedwine.css Deploy/Web
      cp boxedwine-shell.js Deploy/Web
      cp Build/Release/boxedwine.js Deploy/Web
      cp Build/Release/boxedwine.wasm Deploy/Web
      cp /var/www/buildfiles/* Deploy/Web

Running make release failed for me with error "fatal error: 'boxedwine.h' file not found" I was able to fix it by changing: CPPFLAGS ?=.. to CPPFLAGS +=.. in the makefile and then I was able to build for web.

david02871 avatar Feb 16 '25 15:02 david02871

@david02871 That is weird that you needed to change the make file to find boxedwine.h I have never seen that before. I'm definitely not an expert on makefiles, but I assume you had to be in the same directory as the makefile when you called "make release"

danoon2 avatar Feb 16 '25 16:02 danoon2

@Benman2785 emscripten/wasm can be a bit of a pain to get setup. For a pre-built version with an example game you can download the current master build from

http://208.113.165.28:8080/job/Boxedwine/job/master/

The artifact contains builds for all the major platforms I test including emscripten.

Today's direct link

http://208.113.165.28:8080/job/Boxedwine/job/master/lastSuccessfulBuild/artifact/build-108.zip

I'd recommend trying to get the included demo running first before your game. Wasm and browsers require some specific things from the webserver, stuff like strict-origin-when-cross-origin.

And I agree, Boxedwine in general needs more documentation

danoon2 avatar Feb 16 '25 17:02 danoon2

thank you for the already compiled wasm - will try them, yet usually i built myself as i have emscripten running fine for 2-3 other projects. and my webserver is actually already running several wasm-based software -> its quiet charming :)

thank you for your quick answers

Benman2785 avatar Feb 19 '25 18:02 Benman2785