Carbon Interface/ja

│ Deutsch (de) │ English (en) │ 日本語 (ja) │

This article applies to macOS only.

See also: Multiplatform Programming Guide

これはなんのために使いますか

Carbonウィジェットセットは開発の初期段階で、Lazarus IDE上でMac OS X向けの開発を行う際に強く推奨されます。くわしくはMac OS XでのLazarusのインストールを見てください。

The Carbon widgetset is in an early stage of development. A fully functional Lazarus IDE on Mac OS X is strongly recommended. For instructions see Installing Lazarus on Mac OS X.

carbonproof Lazarusを取得する

• Mac OS X用のSubversionクライアントを取得します: Martin Ottによるパッケージはすばらしいものです.
• Install SVN for Mac OS X: A good package is provided by Martin Ott.

• Lazarusのインストール-Subversionからの取得を行って下さい
• Then follow Installing_Lazarus#Downloading_Lazarus_SVN

• Lazarusを起動します。IDEから新しいプロジェクトを開始し、空のフォームを出します。このプロジェクトを適当な名前で保存します。例えば/Users/<yourUsername>/pascal/test/project1.lpiといった具合にです。
• Start Lazarus. The IDE will start with a new project with an empty form. Save this project under a name of your choice. In the following examples we assume this to be /Users/<yourUsername>/pascal/test/project1.lpi

Compiling Carbon interface via Makefile

Type in terminal:

make lcl LCL_PLATFORM=carbon

Compiling the Lazarus IDE with the Carbon interface via Makefile (only for alpha-testing)

Type in terminal:

make all LCL_PLATFORM=carbon OPT="-k-framework -kcarbon -k-framework -kOpenGL"

Important notes about the Carbon IDE

• You must run Lazarus via lazarus.app.

• Make sure your editor is using a mono-font. You can check that on the Editor Options dialog. The "Monaco" font is a good suggestion.

Known Carbon IDE bugs

• http://bugs.freepascal.org/view.php?id=10818

• Sometimes crashes on exit. Not reliably reproducible yet.

Compiling the Carbon Interface

We now assume your Lazarus directory is located at /Users/<yourUsername>/pascal/lazarus/

• Start Lazarus.
• Set Environment>Environment Options>Files>Lazarus Directory to /Users/<yourUsername>/pascal/lazarus/
• Set Tools>Configure "Build Lazarus"> to

and add this to your 'Options':

-k-framework -kcarbon -k-framework -kOpenGL

This will prevent unresolved symbols (Carbon-symbols like _ActivateWindow) while linking lazarus.

• Tools>Build Lazarus -- This will compile the Carbon Interface and put the .ppu files into /Users/<yourUsername>/pascal/lazarus/lcl/units/powerpc-darwin and /Users/<yourUsername>/pascal/lazarus/lcl/units/powerpc-darwin/carbon

Your first native Carbon App

Compiler Options

Set Project > Compiler Options > Paths > LCL Widget Type to carbon

You should now be able to compile the project without errors. It will create an executable project1, but you cannot focus it. That's because Mac OS X expects some hidden resource files.

Creating the Apple Resource files

There is a tool to create these files.

Open /Users/<yourUserName>/pascal/lazarus/components/macfiles/examples/createmacapplication.lpi in the IDE. Compile.

Open a Terminal of your choice. Type:

cd /Users/<yourUserName>/pascal/project1/
/Users/<yourUserName>/pascal/lazarus/components/macfiles/examples/createmacapplication project1
ln -s ../../../project1 project1.app/Contents/MacOS/project1

Now you can start the program via its Finder icon or in the native Mac OS Terminal via ./project1.app/Contents/MacOS/project1

Carbon interface internals

If you want to help improving the carbon interface, see here

Carbon interface internals