Programming AmigaOS 4: The Development Environment - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:09:08Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

← Older revision		Revision as of 19:09, 26 January 2025
Line 35:		Line 35:
	To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed.		To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	/*		/*
	** check_os4.1.c : Check for AmigaOS 4.1 enviroment		** check_os4.1.c : Check for AmigaOS 4.1 enviroment

Steven Solie: /* Outlook */

2016-09-24T17:56:11Z

Outlook

← Older revision		Revision as of 17:56, 24 September 2016
Line 68:		Line 68:

	When run it'll output an appropriate text. This codeblock is suitable if you want to make sure that your program requires a specific OS version. For this, these values are significant: 50 stands for AmigaOS 4.0 preview, 51 for 4.0 final, 52 for 4.0 update 4 and the current 53 for 4.1. Generally, you can expect version 53 to be running.		When run it'll output an appropriate text. This codeblock is suitable if you want to make sure that your program requires a specific OS version. For this, these values are significant: 50 stands for AmigaOS 4.0 preview, 51 for 4.0 final, 52 for 4.0 update 4 and the current 53 for 4.1. Generally, you can expect version 53 to be running.

	= Outlook =

	The next installment will get us right into coding. The first thing the Amiga starts is the kernel and for this we'll take a look at Exec and the basic functions it provides.

	= Authors =		= Authors =

Steven Solie: /* The first step */

2016-09-24T17:55:44Z

The first step

← Older revision		Revision as of 17:55, 24 September 2016
Line 37:		Line 37:
	<syntaxhighlight>		<syntaxhighlight>
	/*		/*
	** check_os4.1.c : ~~Pr¸fen auf AmigaOS 4.1 Umgebung /~~ Check for AmigaOS 4.1 enviroment		** check_os4.1.c : Check for AmigaOS 4.1 enviroment
	** gcc check_os4.1.c -o check_os4.1		** gcc check_os4.1.c -o check_os4.1
	*/		*/
Line 50:		Line 50:
	if(SysBase->lib_Version >= 53)		if(SysBase->lib_Version >= 53)
	{		{
	IDOS->Printf("AmigaOS 4.1 ist vorhanden !\n");
	IDOS->Printf("AmigaOS 4.1 is available !\n");		IDOS->Printf("AmigaOS 4.1 is available !\n");
	res = RETURN_OK;		res = RETURN_OK;
Line 56:		Line 55:
	else		else
	{		{
	IDOS->Printf("~~Das~~ ~~Programm~~ ~~benˆtigt~~ AmigaOS 4.1\n");		IDOS->Printf("This program requires AmigaOS 4.1\n");
	IDOS->Printf("This program required AmigaOS 4.1\n");
	res = RETURN_FAIL;		res = RETURN_FAIL;
	}		}

	return( res );		return res;
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Steven Solie: /* Development Environment */

2016-08-30T04:36:19Z

Development Environment

← Older revision		Revision as of 04:36, 30 August 2016
Line 18:		Line 18:

	There's the new [https://www.alinea-computer.de/produkte_details_en.php?product=stormc5ed StormC5 Editor], optimized for developers, with several features. We've covered this editor in Amiga Future's previous issue 102. StormC5 is planned to become a complete DE with project management and "integrated" compiler again.		There's the new [https://www.alinea-computer.de/produkte_details_en.php?product=stormc5ed StormC5 Editor], optimized for developers, with several features. We've covered this editor in Amiga Future's previous issue 102. StormC5 is planned to become a complete DE with project management and "integrated" compiler again.

			[[File:AF103_programmcode_eng.png\|frame\|center]]

	Additional editors are [http://www.cygnused.de/index-en.php CygnusEd] and GoldEd. Also, the operating system's Notepad is generally suitable for creating code, probably limited to smaller/shorter programs however.		Additional editors are [http://www.cygnused.de/index-en.php CygnusEd] and GoldEd. Also, the operating system's Notepad is generally suitable for creating code, probably limited to smaller/shorter programs however.

Steven Solie: /* SDK */

2016-08-30T04:33:56Z

SDK

← Older revision		Revision as of 04:33, 30 August 2016
Line 6:		Line 6:

	The Software Development Kit (SDK) for AmigaOS 4 has had some updates. You can find the latest version on from March 2010 on [http://www.hyperion-entertainment.biz/index.php?option=com_registration&view=files&parent=30&Itemid=63 Hyperion Entertainment's website]. The archive is easy to install and you can select which components you require. The base archives are always installed, and if you wish to use additional contributions you can select the appropriate archives. The installation has already been covered in Amiga Future 81 page 28 ([http://www.amigafuture.de/kb.php?mode=article&k=4174 link]) and issue 84 page 17 ([http://www.amigafuture.de/kb.php?mode=article&k=4325 link]). The SDK: assign holds all documentation ([[Autodocs:Main\|Autodocs]]) and include files (include/include_h), the latter are required for developing your own code and they're included in the compiler's search path.		The Software Development Kit (SDK) for AmigaOS 4 has had some updates. You can find the latest version on from March 2010 on [http://www.hyperion-entertainment.biz/index.php?option=com_registration&view=files&parent=30&Itemid=63 Hyperion Entertainment's website]. The archive is easy to install and you can select which components you require. The base archives are always installed, and if you wish to use additional contributions you can select the appropriate archives. The installation has already been covered in Amiga Future 81 page 28 ([http://www.amigafuture.de/kb.php?mode=article&k=4174 link]) and issue 84 page 17 ([http://www.amigafuture.de/kb.php?mode=article&k=4325 link]). The SDK: assign holds all documentation ([[Autodocs:Main\|Autodocs]]) and include files (include/include_h), the latter are required for developing your own code and they're included in the compiler's search path.

			[[File:AF103_sdk_installer.png\|frame\|center]]

	= Compiler =		= Compiler =

Eldee Stephens: added a few links

2016-08-29T14:55:56Z

added a few links

← Older revision		Revision as of 14:55, 29 August 2016
Line 1:		Line 1:
			''This article was adapted from Amiga Future magazine's series on developing for AmigaOS....''
⚫	We were shocked when we realised that while we've covered several subjects in programming for AmigaOS 4 in Amiga Future there's been no extensive coverage of all of the many aspects. Additionally, since the release of AmigaOS 4, quite a lot of time has passed by, and during that time new programming treasures have sneaked into the SDK virtually unnoticed. It's been nine years since the authors did a similar series in "Amiga Magazin". So, we're launching a new 15-part series starting with a short peek at the SDK and the available development environments.

		⚫	We were shocked when we realised that while we've covered several subjects in programming for AmigaOS 4 in [http://www.amigafuture.de Amiga Future] there's been no extensive coverage of all of the many aspects. Additionally, since the release of AmigaOS 4, quite a lot of time has passed by, and during that time new programming treasures have sneaked into the SDK virtually unnoticed. It's been nine years since the authors did a similar series in "Amiga Magazin". So, we're launching a new 15-part series starting with a short peek at the SDK and the available development environments.

	= SDK =		= SDK =

	The Software Development Kit (SDK) for AmigaOS 4 has had some updates. You can find the latest version on from March 2010 on [http://www.hyperion-entertainment.biz/index.php?option=com_registration&view=files&parent=30&Itemid=63 Hyperion Entertainment's website]. The archive is easy to install and you can select which components you require. The base archives are always installed, and if you wish to use additional contributions you can select the appropriate archives. The installation has already been covered in Amiga Future 81 page 28 and issue 84 page 17. The SDK: assign holds all documentation (Autodocs) and include files (include/include_h), the latter are required for developing your own code and they're included in the compiler's search path.		The Software Development Kit (SDK) for AmigaOS 4 has had some updates. You can find the latest version on from March 2010 on [http://www.hyperion-entertainment.biz/index.php?option=com_registration&view=files&parent=30&Itemid=63 Hyperion Entertainment's website]. The archive is easy to install and you can select which components you require. The base archives are always installed, and if you wish to use additional contributions you can select the appropriate archives. The installation has already been covered in Amiga Future 81 page 28 ([http://www.amigafuture.de/kb.php?mode=article&k=4174 link]) and issue 84 page 17 ([http://www.amigafuture.de/kb.php?mode=article&k=4325 link]). The SDK: assign holds all documentation ([[Autodocs:Main\|Autodocs]]) and include files (include/include_h), the latter are required for developing your own code and they're included in the compiler's search path.

	= Compiler =		= Compiler =
Line 11:		Line 13:
	= Development Environment =		= Development Environment =

	Currently, the only complete development environment is "Codebench". It allows you to easily join several files into a project, the makefile is created automatically. You can call the compiler directly from the DE.		Currently, the only complete development environment is [http://codebench.co.uk Codebench]. It allows you to easily join several files into a project, the makefile is created automatically. You can call the compiler directly from the DE.

	There's the new "StormC5 Editor", ~~optimised~~ for developers, with several features. We've covered this editor in Amiga Future's previous issue 102. StormC5 is planned to become a complete DE with project management and "integrated" compiler again.		There's the new [https://www.alinea-computer.de/produkte_details_en.php?product=stormc5ed StormC5 Editor], optimized for developers, with several features. We've covered this editor in Amiga Future's previous issue 102. StormC5 is planned to become a complete DE with project management and "integrated" compiler again.

	Additional editors are CygnusEd and GoldEd. Also, the operating system's Notepad is generally suitable for creating code, probably limited to smaller/shorter programs however.		Additional editors are [http://www.cygnused.de/index-en.php CygnusEd] and GoldEd. Also, the operating system's Notepad is generally suitable for creating code, probably limited to smaller/shorter programs however.

	Generally, you can still use the older environments MaxonDevelop and StormC4. They feature project management and editors and provide for managing projects and editing the source code files. The required makefiles would need to be created manually however, the same applies to compiler or make calls.		Generally, you can still use the older environments MaxonDevelop and [https://www.alinea-computer.de/produkte_details_en.php?product=stormc StormC4]. They feature project management and editors and provide for managing projects and editing the source code files. The required makefiles would need to be created manually however, the same applies to compiler or make calls.

	= Documentation =		= Documentation =

Steven Solie: /* Authors */

2016-08-29T04:26:51Z

Authors

← Older revision		Revision as of 04:26, 29 August 2016
Line 71:		Line 71:
	= Authors =		= Authors =

	Written by Michael Christoph and Nils Petersen		Written by Michael Christoph and Nils Petersen<br/>
	Copyright (c) 2013 Michael Christoph		Copyright (c) 2013 Michael Christoph

Steven Solie: /* The first step */

2016-08-29T04:16:53Z

The first step

@@ Line 27: / Line 27: @@
 = The first step =
-To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed. You can compile it directly from the console by
+To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed.
  gcc check_os4.1.c -o check_os4.1

Steven Solie: /* The first step */

2016-08-29T04:15:23Z

The first step

← Older revision		Revision as of 04:15, 29 August 2016
Line 27:		Line 27:
	= The first step =		= The first step =

	To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed. You can compile it directly from the console by "gcc check_os4.1.c -o check_os4.1". When run it'll output an appropriate text. This codeblock is suitable if you want to make sure that your program requires a specific OS version. For this, these values are significant: 50 stands for AmigaOS 4.0 preview, 51 for 4.0 final, 52 for 4.0 update 4 and the current 53 for 4.1. Generally, you can expect version 53 to be running.		To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed. You can compile it directly from the console by

			gcc check_os4.1.c -o check_os4.1

			When run it'll output an appropriate text. This codeblock is suitable if you want to make sure that your program requires a specific OS version. For this, these values are significant: 50 stands for AmigaOS 4.0 preview, 51 for 4.0 final, 52 for 4.0 update 4 and the current 53 for 4.1. Generally, you can expect version 53 to be running.

	= Outlook =		= Outlook =

Steven Solie: Created page with "We were shocked when we realised that while we've covered several subjects in programming for AmigaOS 4 in Amiga Future there's been no extensive coverage of all of the many a..."

2016-08-29T04:14:30Z

Created page with "We were shocked when we realised that while we've covered several subjects in programming for AmigaOS 4 in Amiga Future there's been no extensive coverage of all of the many a..."

New page

We were shocked when we realised that while we've covered several subjects in programming for AmigaOS 4 in Amiga Future there's been no extensive coverage of all of the many aspects. Additionally, since the release of AmigaOS 4, quite a lot of time has passed by, and during that time new programming treasures have sneaked into the SDK virtually unnoticed. It's been nine years since the authors did a similar series in "Amiga Magazin". So, we're launching a new 15-part series starting with a short peek at the SDK and the available development environments.

= SDK =

The Software Development Kit (SDK) for AmigaOS 4 has had some updates. You can find the latest version on from March 2010 on [http://www.hyperion-entertainment.biz/index.php?option=com_registration&view=files&parent=30&Itemid=63 Hyperion Entertainment's website]. The archive is easy to install and you can select which components you require. The base archives are always installed, and if you wish to use additional contributions you can select the appropriate archives. The installation has already been covered in Amiga Future 81 page 28 and issue 84 page 17. The SDK: assign holds all documentation (Autodocs) and include files (include/include_h), the latter are required for developing your own code and they're included in the compiler's search path.

= Compiler =

The package installs the gcc compiler version 4.2.4, suitable for developing programs in C and C++. You can also create shared libraries, link libraries and shared object files (sobj). A detailed description of gcc and its command-line options can be found in SDK:Documentation.

= Development Environment =

Currently, the only complete development environment is "Codebench". It allows you to easily join several files into a project, the makefile is created automatically. You can call the compiler directly from the DE.

There's the new "StormC5 Editor", optimised for developers, with several features. We've covered this editor in Amiga Future's previous issue 102. StormC5 is planned to become a complete DE with project management and "integrated" compiler again.

Additional editors are CygnusEd and GoldEd. Also, the operating system's Notepad is generally suitable for creating code, probably limited to smaller/shorter programs however.

Generally, you can still use the older environments MaxonDevelop and StormC4. They feature project management and editors and provide for managing projects and editing the source code files. The required makefiles would need to be created manually however, the same applies to compiler or make calls.

= Documentation =

A constant issue is the inadequate, incomplete, and even some missing, documentation to the application programming interface (API). The first place to go would be the Autodocs files, at least providing short descriptions for each function, what parameters are to be passed to the function, which return values there are, and what purpose the function serves. The Autodocs should cover all functions although not always with up-to-date descriptions.

Fortunately, there is this wiki where you can find numerous descriptions and sample code. Additionally, you can try to [http://support.amigaos.net/ contact fellow developers]. If you require more of a tutorial or description of the architectural aspects you should look into the RKRMs revised and updated on this wiki. A look into [http://os4depot.net/index.php?function=browse&cat=development OS4Depot] can also provide helpful tools and sample code for developers. A short overview has been given in issue 79 page 25.

= The first step =

To avoid keeping this first part all theoretical we'd like to use a mini program to check whether AmigaOS version 4.1 (or better) is installed. You can compile it directly from the console by "gcc check_os4.1.c -o check_os4.1". When run it'll output an appropriate text. This codeblock is suitable if you want to make sure that your program requires a specific OS version. For this, these values are significant: 50 stands for AmigaOS 4.0 preview, 51 for 4.0 final, 52 for 4.0 update 4 and the current 53 for 4.1. Generally, you can expect version 53 to be running.

= Outlook =

The next installment will get us right into coding. The first thing the Amiga starts is the kernel and for this we'll take a look at Exec and the basic functions it provides.

= Authors =

Written by Michael Christoph and Nils Petersen
Copyright (c) 2013 Michael Christoph