How to install sdl3 library?

[ahmet111]

I tried many ways and couldn’t install it. How can I install it? Is there a source that explains it step by step?

[vulpesx]

assuming your talking about adding it as a dependency

GitHub - castholm/SDL: SDL ported to the Zig build system

[ahmet111]

I couldn’t understand what was in the link you gave. How to set it up? How will it work? Is there a step-by-step article or video explaining this?

[Sze]

Have you looked at the examples?

zig-examples/breakout at master · castholm/zig-examples

I think wanting a video tutorial for every specific thing is a trap that can keep you from learning how to progress and become self-reliant, I think instead it is better to learn how to utilize general learning materials (including videos, blog posts / articles, etc.) to build your skills and fill in gaps in your knowledge.

Let us know what topics specifically you need help with, so we can point you to resources that are about that topic. We don’t know what you know, or don’t know.

It doesn’t make sense to make a “how to start from nothing” tutorial for every project you could create with a programming language.

Here are some general learning resources:

Zig Learning Resources

Zig is still a relatively young programming language and yet to reach a 1.0 release. This is why it’s rapidly evolving and breaking changes between releases are expected. This makes it a hard moving target when trying to develop and maintain learning resources about the language and its ecosystem. Nevertheless, there are already some very good resources available and we invite the community to add their own and help keep this list up-to-date. The list is not in any particular order to make it ea…

Do these help you?
If not, what do you need help with?

[ahmet111]

I can’t use the sld3 library with zig. I looked at articles and videos about what to do at first. and none of them helped me. I asked chatgpt. All of the dozens of suggestions he gave me came up with errors. I can’t find a solution. I couldn’t even get an sdl output that would write text to the screen at the simplest level. I’m looking for a source that will explain this step by step. There aren’t many sources about the zig language. The examples you gave are quite complicated and are made into games. I couldn’t include the sld3 library either.

[Sze]

• create a new zig project using zig init
• add the sdl dependency by using zig fetch
• add the dependency and import to your build.zig
• add the @import to the code
• change the code to be equivalent to a simple sdl example

I think all these steps are simple steps you should be able to figure out mostly on your own, by making use of the learning resources / using existing answers, or at least tell us where you got error messages.

I am not going to spoon-feed you a customized tutorial, get to work and ask questions if you get stuck.

[LucasSantos91]

Did you try using Castholm’s port that was linked above? It’s pretty much plug and play.
Also, you can compile SDL3 with a C compiler and just link the static library with zig. This is the closest to the intended way of using the library.
You haven’t made it clear how experienced you are with tools. In order to help you, we would need to know if you are experienced with C, SDL or Zig.

[ahmet111]

• add the sdl dependency by using zig fetch
• How do I do this step?

[ahmet111]

Castholm’
I don’t understand how to use this.
I have little knowledge about c and zig. I am a beginner.

[Sze]

GitHub - castholm/SDL: SDL ported to the Zig build system

The zig fetch line under the usage headline.

[ahmet111]

C:\Users\XX>zig fetch --save git+https://github.com/castholm/SDL.git
C:\Users\XX\AppData\Local\zig\tmp\a675f85c09fa1f87\build.zig.zon:5:14: error: expected string literal
.name = .sdl,

[Sze]

what is the output of?:

zig version

[ahmet111]

zig version
0.13.0

[Sze]

You need to get zig 0.14.0 the readme of sdl states that it requires it. (at least that is simpler than using an older version of the sdl library)

[ahmet111]

info: resolved to commit
I did the fetch step. This article appeared. I made the version 15.0. How do I do the next step?

[Sze]

@Sze

add the dependency and import to your build.zig

This one? Pretty much like here:

breakout/build.zig

[ahmet111]

I copied and pasted the codes into a file called build.zig. You said add and import the dependency. What does this mean and how should I do it?

[Sze]

You don’t need to add a module import, that was before I saw how the breakout example just uses @cImport, I think you can continue with this:

SDL3 ported to the Zig build system (with example games)

It’s possible to use the main callbacks, but you can’t just #define SDL_MAIN_USE_CALLBACKS 1 like you would in C. Instead, you have to call SDL_EnterAppMainCallbacks() manually by passing the callbacks as function pointers. Here’s a more or less 1:1 port of their callbacks template: const c = @cImport({ @cDefine("SDL_DISABLE_OLD_NAMES", {}); @cInclude("SDL3/SDL.h"); // For programs that provide their own entry points instead of relying on SDL's main function // macro magic, 'SDL…

Or you can do what

breakout/main.zig

does and remove everything you don’t need.

I think that are basically two different styles of using the library.
The first is using callbacks and the breakout example is using a while loop.

[ahmet111]

I don’t understand. Where do I add the last codes you gave me?

[Sze]

Your src/main.zig needs code, personally I would start with the breakout code and step by step remove all the things that aren’t needed.