Cookbook + iOS SDK Update

Armelline · March 31

@adent42 Just a couple of notes in case they haven't been brought to GS's attention:

iOS builds are currently returning this warning:

ITMS-90725: SDK version issue - This app was built with the iOS 17.4 SDK. Starting April 24, 2025, all iOS and iPadOS apps must be built with the iOS 18 SDK or later, included in Xcode 16 or later, in order to be uploaded to App Store Connect or submitted for distribution.

Additionally, but unrelatedly, the GameSalad Cookbook is currently offline.

adent42 · April 3

The next RC should handle the iOS SDK update.

Cookbook is being retired in favor of Creator 2 built in tutorials, but we know that some stuff is gonna be missed, so let us know what you're looking for and we'll get it up on https://support.gamesalad.com

Armelline · April 4

This was the specific page I was trying to access. It opened fine a few weeks ago but sadly no longer:

https://help.gamesalad.com/knowledge-base/does-the-html5-engine-have-any-apis-i-can-interact-with/

Armelline · April 9

@adent42 Any update on the knowledge base? Hoping to add a fullscreen/windowed option and a quit button to an Tauri HTML5 game but need to get some responses from within the game to hook into. I know you explained how to interact with the HTML5 engine somewhere but doesn't seem to be online anymore. Thanks!

adent42 · April 15

I haven't had a chance yet. Here's the other doc we have on this, I should be able to dig something up shortly:

https://docs.google.com/document/d/e/2PACX-1vQyLKQJrrdDDPAMGWFlmvEpEI4CCpDuoMhRsnAan97LMtF4IGoLzLEMvuhxZV36UytukfoBosnX7OTH/pub

adent42 · April 15

Aaand here's the content from that page for now while you wait for me to work it into our support site:

https://web.archive.org/web/20230925200713/https://help.gamesalad.com/knowledge-base/does-the-html5-engine-have-any-apis-i-can-interact-with/

I retired the help site because it was using a really old version of a wordpress plugin that I figured would be a pain to upgrade. Unfortunately, there's a lot more in that site than I realized, so I'm probably gonna need to spend some time resurrecting it soon.

adent42 · April 15

Here you go!

https://support.gamesalad.com/support/solutions/articles/42000112581

adent42 · April 15

Also decided to get all of these into one place:

https://support.gamesalad.com/support/solutions/articles/42000112583-gamesalad-github-repos-glitch-project-

Armelline · April 15

Thank you! Now to step outside my comfort zone for a bit and try to get it done :D

Armelline · April 17

I've got the quit button working (at least in a test project) but I'm not certain a proper fullscreen/windowed toggle is possible as GS's HTML5 engine seems to only redraw the scene on load, and any toggling isn't triggering a new redraw. I can get around it to some extent with

window.location.reload()

but obviously that's not ideal. Is there anything under-the-hood I can trigger? Being able to quit out of fullscreen is enough, but would love to get a proper toggle going if it's possible.

(Also as an aside I simply couldn't get onEndGame to trigger but was able to hook the quit game into a TweetSheet message instead. Not sure if I was doing something wrong or if onEndGame isn't actually doing what it's supposed to.)

adent42 · April 17

there's a resize event you can use in html5:

if (playerDelegate.onWindowResize) {
    window.addEventListener('resize', playerDelegate.onWindowResize, false);
}

The onWindowResize delegate should be as follow:

onWindowResize: function() {
    engine.relayout();
},

For onEndGame, the code is there, so it should work. Not sure what's up there, so would need to do some testing.

Armelline · April 17

Will try that, thanks!

Armelline · April 17

Looks like it works perfectly, thanks!

I'll try to put together a quick tutorial on how to implement both things in a Tauri app as they (well, quitting the game at least) would seem crucial to any Windows/Linux release and it turned out to be really pretty simple to do (once I had my head around the delegate.js file at least).

Now to start battling the default Tauri installer! Or updating to Tauri 2 as that apparently has more/easier installer options.

adent42 · April 23

Oh, there's a Tauri 2? Might be worth taking some time next weekend to update the github repo to use that!

Armelline · April 24

Sounds great! If it's okay, I'll send the draft of the tutorial I've written (using Tauri + quit button + window mode toggle) over to you so you can check I didn't do anything stupid and (hopefully) note if any of the Tauri 2 changes will break it! Just need to figure out what I did that I don't remember that means the tutorial currently doesn't quite work properly. Might even be worth you including these bits of code in the new repo as I can't imagine there will be many people who will want to publish to Windows and not give the user the option to quit/toggle window (if you publish in fullscreen mode there's no in-built way to quit that I'm aware of and windowed-only mode kinda sucks as a rule).

Cookbook + iOS SDK Update

Comments