dreamcast.wiki - User contributions [en]

Objective-C on Dreamcast

2024-08-04T20:04:06Z

Andrew.apperley: Added the example running and libs base instructions

===This article is actively being worked on===
''Work in progress - items to be added and/or edited'': It is subject to change and utilizes repo forks that might be significantly behind the mainline repos.

<div style="float:right;">__TOC__</div>
=Introduction=
This article will cover the how to setup Objective-C and its Standard Library, Foundation. The following git repos will be used in this guide and will be described in more detail as we go:
* '''Tools-Make''' - provides a set of make files that are used to properly configure Foundation
* '''KOS''' - the main package for making Dreamcast Homebrew. We will need to patch your local git clone with pthread support
* '''Libs-Base''' - provides the Foundation library for Objective-C
* '''LibFFI''' - used for NSTimers and NSInvocation support

Important note: If you haven't setup KOS yet, you must follow the [[Getting Started with Dreamcast development|Getting Started Guide]]. You can then come back and continue with this one.

=Preparation=
We must first configure and install the prerequisites for Foundation. These include libffi and Tools-Make.

== Libffi ==
==== Clone the repo ====
git clone git@github.com:andrewapperley/libffi.git

==== Execute the configure command ====
CC=kos-cc CXX=kos-c++ ./configure --host=sh-elf --target=sh-elf

==== Execute the make command ====
make

==== Execute the make install command ====
make install

== Tools Make ==
==== Clone the repo ====
git clone git@github.com:andrewapperley/tools-make.git

==== Switch to DC branch ====
git fetch
git checkout origin/DC
git pull

==== Execute the configure command ====
CC=kos-cc CXX=kos-c++ ./configure --host=sh-elf --target=sh-elf --prefix=/opt/gnustep --enable-nxconstantstring --disable-tls --disable-icu --disable-iconv --disable-libdispatch --disable-xslt --disable-xml --enable-procfs-psinfo --enable-procfs

==== Execute the make command ====
make

==== Execute the make install command ====
make install

== Libs Base ==
==== Clone the repo ====
git clone git@github.com:andrewapperley/libs-base.git

==== Switch to DC branch ====
git fetch
git checkout origin/DC
git pull

==== Execute the configure command ====
CC=kos-cc CXX=kos-c++ ./configure --host=sh-elf --target=sh-elf --prefix=/opt/gnustep --enable-nxconstantstring --disable-tls --disable-icu --disable-iconv --disable-libdispatch --disable-xslt --disable-xml --enable-procfs-psinfo --enable-procfs

==== Execute the make command ====
make

==== Execute the make install command ====
make install

=Running an example=
Currently the main KOS repo doesn't have pthread support added to master, for now you must have the pthreads branch rebased onto a local branch. I have gone ahead and done this on a personal fork. This shouldn't be the case forever and doing this has it's drawbacks, such as your branch falling behind the active development branch quite easily.

You'll need to take the libgnustep-base.a, libffi.a, and the headers of each library and place them where KOS can find them. This needs to happen every time you alter the source files within those project folders.

==== Switch to Objc branch ====
git fetch
git checkout origin/dc-objc
git pull

==== Execute the examples ====
make ./examples/dreamcast/objc/runtime
make ./examples/dreamcast/objc/foundation

Objective-C on Dreamcast

2024-06-06T20:49:51Z

Andrew.apperley: Added the tools make section

Objective-C on Dreamcast

2024-06-06T20:35:08Z

Andrew.apperley: Added the libffi section

{{Note|type=warn|text=This article is a Work in Progress. It is subject to change and utilizes repo forks that might be significantly behind the mainline repo.}}

<div style="float:right;">__TOC__</div>
=Introduction=
This article will cover the how to setup Obective-C and it's Standard Library Foundation. The following git repos will be used in this guide and will be described in more detail as we go:
* '''Tools-Make''' - provides a set of make files that are used to properly configure Foundation
* '''KOS''' - the main package for making Dreamcast Homebrew. We will need to patch your local git clone with pthread support
* '''Libs-Base''' - provides the Foundation library for Objective-C
* '''LibFFI''' - used for NSTimers and NSInvocation support

Important note: If you haven't setup KOS yet, you must follow the [[Getting Started with Dreamcast development|Getting Started Guide]]. You can then come back and continue with this one.

=Preparation=
We must first configure and install the prerequisites for Foundation. These include libffi and Tools-Make.

== Libffi ==
==== Clone the ffi repo ====
git clone git@github.com:andrewapperley/libffi.git

==== Execute the configure command ====
CC=kos-cc CXX=kos-c++ ./configure --host=sh-elf --target=sh-elf

==== Execute the make command ====
make

==== Execute the make install command ====
make install

Objective-C on Dreamcast

2024-05-30T14:14:02Z

Andrew.apperley:

<div style="float:right;">__TOC__</div>
=Introduction=
This article will cover the how to setup Obective-C and it's Standard Library Foundation. The following git repos will be used in this guide and will be described in more detail as we go:
* '''Tools-Make''' - provides a set of make files that are used to properly configure Foundation
* '''KOS''' - the main package for making Dreamcast Homebrew. We will need to patch your local git clone with pthread support
* '''Libs-Base''' - provides the Foundation library for Objective-C
* '''LibFFI''' - used for NSTimers and NSInvocation support

Important note: If you haven't setup KOS yet, you must follow the [[Getting Started with Dreamcast development|Getting Started Guide]]. You can then come back and continue with this one.

Objective-C on Dreamcast

2024-05-24T18:45:33Z

Andrew.apperley: page contents will be added soon

TODO

Programming language support

2024-05-24T18:44:10Z

Andrew.apperley: /* Compiled languages */

The following languages can be used in Sega Dreamcast programming:

=Assembly languages=
* '''SH4 assembly''', as the native machine code for the Dreamcast's SuperH processor
* '''ARM assembly''', as the native machine code for the Dreamcast's AICA ARM7DI sound processor

=Compiled languages=
* '''C''', the predominant language for Sega Dreamcast development, via the GCC C compiler.
* '''C++''', commonly used and very well-supported, via the GCC C++ compiler.
* '''Objective-C''', via the GCC Objective-C compiler. Preliminary support for Foundation framework via [https://gnustep.github.io/ GNUstep] is being developed. See [https://twitter.com/dinobj_c/status/1732399498977276154 Andrew Apperley's X account]. See [[Objective-c on Dreamcast]] for more information.
** The GNU '''Objective-C++''' extension is available as well.
* '''Rust''', via rustc_codegen_gcc and libgccjit, or via gccrs. When using rustc_codegen_gcc, the core and alloc libraries are available, with bindings to KallistiOS being developed. See [[Rust on Dreamcast]] for more information.
* '''D''', via the GCC D compiler. Early support, see [https://dreamcast.wiki/D_on_Dreamcast D on Dreamcast] for more information.
* '''Ada''', via GNAT. [https://github.com/dkm/ada-dreamcast-helloworld Ada 3D cube demo] by [https://poulhies.fr/ Marc Poulhiès].
* '''Fortran''', via GFortran. Requires some work to create a cross-compiler, but does work.

=Scripting/Interpreted languages=
* Lua (available in [[kos-ports]])
* MicroPython (available in [[kos-ports]])
* Tcl (available in [[kos-ports]])
* mRuby (available in [[kos-ports]])
* AngelScript
* QuickJS

Programming language support

2024-05-24T18:43:40Z

Andrew.apperley: Added link to objc on dc page

The following languages can be used in Sega Dreamcast programming:

=Assembly languages=
* '''SH4 assembly''', as the native machine code for the Dreamcast's SuperH processor
* '''ARM assembly''', as the native machine code for the Dreamcast's AICA ARM7DI sound processor

=Compiled languages=
* '''C''', the predominant language for Sega Dreamcast development, via the GCC C compiler.
* '''C++''', commonly used and very well-supported, via the GCC C++ compiler.
* '''Objective-C''', via the GCC Objective-C compiler. Preliminary support for Foundation framework via [https://gnustep.github.io/ GNUstep] is being developed. See [https://twitter.com/dinobj_c/status/1732399498977276154 Andrew Apperley's X account].
** The GNU '''Objective-C++''' extension is available as well.
See [[Objective-c on Dreamcast]] for more information.
* '''Rust''', via rustc_codegen_gcc and libgccjit, or via gccrs. When using rustc_codegen_gcc, the core and alloc libraries are available, with bindings to KallistiOS being developed. See [[Rust on Dreamcast]] for more information.
* '''D''', via the GCC D compiler. Early support, see [https://dreamcast.wiki/D_on_Dreamcast D on Dreamcast] for more information.
* '''Ada''', via GNAT. [https://github.com/dkm/ada-dreamcast-helloworld Ada 3D cube demo] by [https://poulhies.fr/ Marc Poulhiès].
* '''Fortran''', via GFortran. Requires some work to create a cross-compiler, but does work.

=Scripting/Interpreted languages=
* Lua (available in [[kos-ports]])
* MicroPython (available in [[kos-ports]])
* Tcl (available in [[kos-ports]])
* mRuby (available in [[kos-ports]])
* AngelScript
* QuickJS