Hello, Mac – チュートリアル

[アーティクル]
07/13/2023

Xamarin.Mac を使うと、Objective-C または Swift で開発するときに使用するのと同じ macOS API を使用して、C# と .NET で完全にネイティブな Mac アプリを開発できます。 Xamarin.Mac は直接 Xcode と統合できるため、開発者は Xcode の Interface Builder を使用して、アプリのユーザーインターフェイスを作成できます (または、必要に応じて C# コードで直接作成することも可能です)。

さらに、Xamarin.Mac アプリケーションは C# と .NET で記述されているため、コードを Xamarin.iOS や Xamarin.Android モバイルアプリと共有し、なおかつ各プラットフォームでネイティブエクスペリエンスを提供することができます。

この記事では、ボタンがクリックされた回数を数えるシンプルな Hello Mac アプリを構築するプロセスを示しながら、Xamarin.Mac、Visual Studio for Mac、Xcode の Interface Builder を使用して Mac アプリを作成するために必要な主要概念を紹介します。

次の概念について説明します。

Visual Studio for Mac – Visual Studio for Mac の概要と、それを使用して Xamarin.Mac アプリケーションを作成する方法。
Xamarin.Mac アプリケーションの構造 – Xamarin.Mac アプリケーションの構成。
Xcode の Interface Builder – Xcode の Interface Builder を使用してアプリのユーザーインターフェイスを定義する方法。
Outlet と Action – Outlet と Action を使用してユーザーインターフェイスのコントロールを接続する方法。
配置/テスト – Xamarin.Mac アプリを実行してテストする方法。

要件

Xamarin.Mac アプリケーションの開発に必要な条件は次のとおりです。

macOS High Sierra (10.13) 以上を実行している Mac コンピューター。
Xcode 10 以上。
Xamarin.Mac と Visual Studio for Mac の最新バージョン。

Xamarin.Mac を使って構築されたアプリケーションを実行するには、次のものが必要です。

macOS 10.7 以上を搭載している Mac コンピューター。

警告

今度の Xamarin.Mac 4.8 リリースでは、macOS 10.9 以降のみをサポートします。以前のバージョンの Xamarin.Mac では macOS 10.7 以降をサポートしていましたが、これらの古い macOS バージョンは TLS 1.2 をサポートするための十分な TLS インフラストラクチャがありませんでした。 macOS 10.7 または macOS 10.8 をターゲットにするには、Xamarin.Mac 4.6 以前を使用してください。

Visual Studio for Mac で新しい Xamarin.Mac アプリを起動する

前述のように、このガイドでは、Hello_Mac という Mac アプリを作成する手順を説明します。このアプリはメインウィンドウにボタンとラベルを 1 つずつ追加します。ボタンがクリックされたとき、クリックされた回数がラベルに表示されます。

使用を開始するには、次の手順を実行します。

Visual Studio for Mac を起動します。
[新しいプロジェクト...] ボタンをクリックして [新しいプロジェクト] ダイアログボックスを開き、[Mac]>[アプリ]>[Cocoa アプリ] の順に選択して [次へ] ボタンをクリックします。
[アプリ名] に「Hello_Mac」と入力し、それ以外はすべて既定値のままにします。 [次へ] をクリックします。
コンピューター上の新しいプロジェクトの場所を確認します。
[作成] ボタンをクリックします。

Visual Studio for Mac で新しい Xamarin.Mac アプリが作成され、アプリのソリューションに追加される既定のファイルが表示されます。

Visual Studio for Mac では、Visual Studio 2019 と同じ [ソリューション] と [プロジェクト] の構造が使用されます。ソリューションは、1 つ以上のプロジェクトを保持できるコンテナーです。プロジェクトには、アプリケーション、サポートライブラリ、テストアプリケーションなどが含まれます。[新しいプロジェクトのファイル] > テンプレートでは、ソリューションとアプリケーションプロジェクトが自動的に作成されます。

Xamarin.Mac アプリケーションの構造

Xamarin.Mac アプリケーションのプログラミングは、Xamarin.iOS を扱う場合とよく似ています。 iOS では、Mac で使われる Cocoa をスリムにしたバージョンである CocoaTouch フレームワークが使用されています。

プロジェクト内のファイルを見てください。

Main.cs には、アプリのメインエントリポイントが含まれています。アプリが起動した時点では、Main クラスには実行される最初のメソッドが含まれます。
AppDelegate.cs には、オペレーティングシステムからのイベントをリッスンする AppDelegate クラスが含まれています。
Info.plist には、アプリケーション名、アイコンなどのアプリのプロパティが含まれています。
Entitlements.plist にはアプリの権利が含まれています。アプリの権利によってサンドボックスや iCloud のサポートなどにアクセスできます。
Main.storyboard ではアプリのユーザーインターフェイス (ウィンドウとメニュー) が定義され、ウィンドウ間の相互接続が Segues 経由でレイアウトされます。ストーリーボードは、ビュー (ユーザーインターフェイス要素) の定義を含む XML ファイルです。このファイルは、Xcode 内の Interface Builder で作成、維持管理することができます。
ViewController.cs はメインウィンドウのコントローラーです。コントローラーについては別の記事で詳しく説明しますが、ここでは、コントローラーを特定のビューのメインエンジンと考えることができます。
ViewController.designer.cs には、メイン画面のユーザーインターフェイスとの統合のための組み込みコードが含まれています。

以下のセクションでは、これらのファイルのいくつかを簡単に見ていきます。後で詳しく説明しますが、まず基本を理解することをお勧めします。

Main.cs

Main.cs ファイルはとてもシンプルです。これには、新しい Xamarin.Mac アプリインスタンスを作成し、OS イベントを処理するクラスの名前を渡す静的 Main メソッドが含まれています。ここでは、AppDelegate クラスが該当します。

using System;
using System.Drawing;
using Foundation;
using AppKit;
using ObjCRuntime;

namespace Hello_Mac
{
    class MainClass
    {
        static void Main (string[] args)
        {
            NSApplication.Init ();
            NSApplication.Main (args);
        }
    }
}

AppDelegate.cs

AppDelegate.cs ファイルには AppDelegate クラスが含まれています。このクラスは、ウィンドウの作成と OS イベントのリッスンを行います。

using AppKit;
using Foundation;

namespace Hello_Mac
{
    [Register ("AppDelegate")]
    public class AppDelegate : NSApplicationDelegate
    {
        public AppDelegate ()
        {
        }

        public override void DidFinishLaunching (NSNotification notification)
        {
            // Insert code here to initialize your application
        }

        public override void WillTerminate (NSNotification notification)
        {
            // Insert code here to tear down your application
        }
    }
}

このコードは、以前に iOS アプリを構築したことがある開発者以外にはおそらくなじみの薄いものですが、かなりシンプルです。

DidFinishLaunching メソッドは、アプリがインスタンス化された後に実行され、実際にアプリのウィンドウを作成して、その中にビューを表示するプロセスを開始します。

WillTerminate メソッドは、ユーザーまたはシステムがアプリのシャットダウンをインスタンス化したときに呼び出されます。開発者はこのメソッドを使用して、アプリが終了する前に最終処理を行う必要があります (ユーザー設定やウィンドウのサイズと位置を保存するなど)。

ViewController.cs

Cocoa (と派生の CocoaTouch) は、モデルビューコントローラー (MVC) パターンと呼ばれるパターンを使用します。 ViewController 宣言は、オブジェクトが実際のアプリウィンドウを制御することを表します。一般に、作成されたすべてのウィンドウ (およびウィンドウ内の他の多くの要素) には、ウィンドウのライフサイクルに関する処理を行うコントローラーがあります。コントローラーは、ウィンドウを表示したり、ウィンドウに新しいビュー (コントロール) を追加したりします。

ViewController クラスはメインウィンドウのコントローラーです。コントローラーによって、メインウィンドウのライフサイクルに関する処理が行われます。これについては後で詳しく説明します。ここでは簡単に見ていきます。

using System;

using AppKit;
using Foundation;

namespace Hello_Mac
{
    public partial class ViewController : NSViewController
    {
        public ViewController (IntPtr handle) : base (handle)
        {
        }

        public override void ViewDidLoad ()
        {
            base.ViewDidLoad ();

            // Do any additional setup after loading the view.
        }

        public override NSObject RepresentedObject {
            get {
                return base.RepresentedObject;
            }
            set {
                base.RepresentedObject = value;
                // Update the view, if already loaded.
            }
        }
    }
}

ViewController.Designer.cs

メインウィンドウクラスのデザイナーファイルは最初は空ですが、Xcode Interface Builder を使用してユーザーインターフェイスを作成すると、Visual Studio for Mac によって自動的に作成されます。

// WARNING
//
// This file has been generated automatically by Visual Studio for Mac to store outlets and
// actions made in the UI designer. If it is removed, they will be lost.
// Manual changes to this file may not be handled correctly.
//
using Foundation;

namespace Hello_Mac
{
    [Register ("ViewController")]
    partial class ViewController
    {
        void ReleaseDesignerOutlets ()
        {
        }
    }
}

デザイナーファイルを直接編集しないでください。デザイナーファイルは Visual Studio for Mac によって自動的に管理され、アプリ内のウィンドウまたはビューに追加されたコントロールへのアクセスに必要なコードを提供します。

Xamarin.Mac アプリプロジェクトを作成し、そのコンポーネントの基本を理解したので、Xcode に切り替え、Interface Builder を使用してユーザーインターフェイスを作成します。

Info.plist

Info.plist ファイルには、名前やバンドル ID などの Xamarin.Mac アプリに関する情報が含まれています。

また、メインインターフェイス ドロップダウンの Xamarin.Mac アプリのユーザーインターフェイスを表示するために使用されるストーリーボードも定義します。上記の例において、ドロップダウンの Main はソリューションエクスプローラーのプロジェクトツリーにある Main.storyboard に関連しています。また、それらを含むアセットカタログ (この場合は AppIcons) を指定することで、アプリのアイコンが定義されます。

Entitlements.plist

アプリの Entitlements.plist ファイルは、Xamarin.Mac アプリのサンドボックスや iCloud などの権利を制御します。

Hello World の例に権利は不要です。次のセクションでは、Xcode の Interface Builder を使用して Main.storyboard ファイルを編集し、Xamarin.Mac アプリの UI を定義する方法を示します。

Xcode と Interface Builder の概要

Xcode の一部として、Apple は Interface Builder というツールを作成しました。このツールを使用すると、開発者はデザイナーでユーザーインターフェイスを視覚的に作成できます。 Xamarin.Mac は Interface Builder とスムーズに統合され、Objective-C ユーザーと同じツールで UI を作成できます。

作業を開始するには、ソリューションエクスプローラーで Main.storyboard ファイルをダブルクリックして、Xcode と Interface Builder での編集用に開きます。

これで、次のスクリーンショットのように Xcode が起動します。

インターフェイスのデザインを始める前に、デザインに使用する主な機能を中心に Xcode の概要を簡単に説明します。

Note

開発者は、Xamarin.Mac アプリのユーザーインターフェイスを作成するのに必ずしも Xcode と Interface Builder を使用する必要はありません。C# コードから UI を直接作成できますが、それについてはこの記事では説明しません。わかりやすくするために、このチュートリアルでは Interface Builder を使用してユーザーインターフェイスを作成します。

Xcode のコンポーネント

Visual Studio for Mac から Xcode で .storyboard ファイルを開くと、左側にプロジェクトナビゲーター、中央にインターフェイス階層とインターフェイスエディター、右側にプロパティとユーティリティのセクションが表示されます。

以下のセクションでは、これらの Xcode の各機能と Xamarin.Mac アプリのインターフェイスを作成する方法について説明します。

Xcode で .storyboard ファイルを開くと、Visual Studio for Mac によって Xcode プロジェクトファイルがバックグラウンドで作成され、Visual Studio for Mac と Xcode の間で変更が通知されます。その後、開発者が Xcode から Visual Studio for Mac に戻ると、このプロジェクトに対する変更は Visual Studio for Mac によって Xamarin.Mac プロジェクトと同期されます。

プロジェクトナビゲーション セクションでは、開発者はこの shim Xcode プロジェクトを構成するすべてのファイル間を移動できます。通常、開発者の関心の対象は、この一覧の .storyboard ファイル (Main.storyboardなど) のみです。

インターフェイス階層

インターフェイス階層セクションでは、開発者はプレースホルダーやメイン ウィンドウなどのユーザーインターフェイスの主要な複数のプロパティに簡単にアクセスできます。このセクションを使用すると、ユーザーインターフェイスを構成する個々の要素 (ビュー) にアクセスしたり、階層内でそれらの要素をドラッグして、入れ子にする方法を調整したりできます。

インターフェイスエディター

[インターフェイスエディター] セクションには、ユーザーインターフェイスをグラフィカルにレイアウトする画面が表示されます。[プロパティ] セクションの [ライブラリ] セクションから要素をドラッグして、デザインを作成します。ユーザーインターフェイス要素 (ビュー) をデザインサーフェイスに追加すると、インターフェイスエディターに表示されている順序でインターフェイス階層セクションに追加されます。

プロパティとユーティリティ

プロパティとユーティリティのセクションは、プロパティ (インスペクターとも呼ばれる) とライブラリという 2 つの主要なセクションに分かれています。

最初はこのセクションはほとんど空ですが、開発者がインターフェイスエディターまたはインターフェイス階層で要素を選択すると、プロパティ セクションには指定した要素と調整可能なプロパティに関する情報が設定されます。

プロパティ セクション内には、次の図に示すように 8 つの異なるインスペクタータブがあります。

プロパティとユーティリティの種類

左から順に次のタブがあります。

ファイルインスペクター – ファイルインスペクターは編集中の Xib ファイルの場所やファイル名などのファイル情報を示します。
クイックヘルプ – クイックヘルプでは、Xcode での選択内容に基づいたヘルプが表示されます。
ID インスペクター – ID インスペクターでは、選択したコントロールまたはビューに関する情報が表示されます。
属性インスペクター – 属性インスペクターを使用すると、開発者は選択したコントロールまたはビューのさまざまな属性をカスタマイズできます。
サイズインスペクター – サイズインスペクターを使用すると、開発者は選択したコントロールまたはビューのサイズとサイズ変更の動作を制御できます。
接続インスペクター – 接続インスペクターには、選択したコントロールのアウトレットとアクションの接続が表示されます。 Outlet と Action については、以下で詳しく説明します。
バインドインスペクター – バインドインスペクターを使用すると、開発者は値が自動的にデータモデルにバインドされるようにコントロールを構成できます。
表示効果インスペクター – 表示効果インスペクターを使用すると、開発者はコントロールにアニメーションなどの効果を指定できます。

ライブラリ セクションでは、コントロールとオブジェクトを探してデザイナーに配置し、グラフィカルにユーザーインターフェイスを構築します。

インターフェイスの作成

Xcode IDE と Interface Builder の基本を理解したら、開発者はメインビューのユーザーインターフェイスを作成できます。

次の手順に従って Interface Builder を使用します。

Xcode で、ライブラリ セクションからボタンをドラッグします。
Interface Editor のビュー (ウィンドウコントローラーの下) にボタンをドロップします。
属性インスペクターの Title プロパティをクリックし、ボタンのタイトルを「クリックしてください」に変更します。
ライブラリセクションからラベルをドラッグします。
Interface Editor のボタンの横にあるウィンドウにラベルをドラッグします。
ラベルの右ハンドルをつかみ、ウィンドウの端に近づくまでドラッグします。
追加したボタンをインターフェイスエディターで選択し、ウィンドウ下部の制約エディター アイコンをクリックします。
エディターの上部で、左上の赤い I ビームをクリックします。これにより、ウィンドウのサイズが変更されても、ボタンが画面の左上隅の同じ位置に維持されます。
次に、[高さ] と [幅] のボックスをクリックし、既定のサイズをそのまま使用します。こうすると、ウィンドウのサイズが変更されても、ボタンが同じサイズに維持されます。
[Add 4 Constraints]\(4 制約の追加\) ボタンをクリックして制約を追加し、エディターを閉じます。
ラベルを選択し、制約エディター アイコンをもう一度クリックします。
制約エディターの上、右、左にある赤い I ビームをクリックすると、指定された X と Y の位置にラベルが固定され、実行中のアプリケーションでウィンドウのサイズが変更されたときに拡大、縮小するように指定されます。
もう一度 [高さ] ボックスをクリックし、既定のサイズをそのまま使用します。次に、[Add 4 Constraints]\(4 制約の追加\) ボタンをクリックして制約を追加し、エディターを閉じます。
ユーザーインターフェイスに対する変更を保存します。

コントロールのサイズ変更と移動中、macOS ヒューマンインターフェイスガイドラインに基づく便利なヒントが Interface Builder に表示されます。これらのガイドラインは、開発者が Mac ユーザーにとって使い慣れた外観と操作感を持つ高品質なアプリを作成するのに役立ちます。

インターフェイス階層セクションを参照して、ユーザーインターフェイスを構成する要素のレイアウトと階層がどのように表示されるかを確認します。

ここから、開発者は必要に応じて項目を選択して編集したり、UI 要素をドラッグして順序を変更したりできます。たとえば、UI 要素が別の要素で覆われている場合、その要素をリストの一番下にドラッグすると、その要素をウィンドウの一番上の項目にすることができます。

ユーザーインターフェイスを作成したら、開発者は UI 項目を公開して、Xamarin.Mac が C# コードでそれらの項目にアクセスして対話できるようにする必要があります。次の「Outlet と Action」のセクションで、その方法を説明します。

Outlet と Action

Outlet と Action とは何でしょうか? 従来の .NET ユーザーインターフェイスプログラミングでは、ユーザーインターフェイスのコントロールは追加時にプロパティとして自動的に公開されます。 Mac では事情が異なり、ビューにコントロールを追加しただけでは、コントロールはコードにアクセスできません。開発者は、UI 要素を明示的にコードに公開する必要があります。これを行うために、Apple は 2 つのオプションを提供しています。

Outlet – Outlet はプロパティに似ています。開発者がコントロールをアウトレットに接続すると、プロパティを介してコードに公開されるため、イベントハンドラーをアタッチしたり、メソッドを呼び出したりする操作を行うことができます。
アクション – アクションは WPF のコマンドパターンに似ています。たとえば、コントロールに対してボタンのクリックなどのアクションが実行されると、コントロールはコード内でメソッドを自動的に呼び出します。開発者は多くのコントロールを同じアクションに接続できるため、アクションは強力で便利です。

Xcode では、Outlet と Action はコントロールのドラッグで直接コードに追加されます。具体的には、アウトレットまたはアクションを作成するために、開発者はアウトレットまたはアクションを追加するコントロール要素を選択し、キーボードの Control キーを押したまま、コントロールをコードに直接ドラッグします。

Xamarin.Mac 開発者にとって、これは開発者がアウトレットまたはアクションを作成する Objective-C スタブファイル (C# ファイルに対応) にドラッグすることを意味します。 Visual Studio for Mac は、Interface Builder を使用するために生成した shim Xcode プロジェクトの一部として ViewController.h というファイルを作成しました。

このスタブ .h ファイルは、新しい NSWindow が作成されたときに自動的に Xamarin.Mac プロジェクトに追加される ViewController.designer.cs を反映しています。このファイルは、Interface Builder によって行われた変更を同期するためにも使用されます。そしてこのファイルで Outlet と Action が作成され、UI 要素が C# コードに公開されます。

アウトレットの追加

Outlet と Action が何であるかの基本を理解したので、作成したラベルを C# コードに公開するOutlet を作成します。

次の操作を行います。

Xcode の画面の右上の端にある二連の輪のボタンをクリックして、アシスタントエディターを開きます。
Xcode が分割ビューモードに切り替わり、一方の側にインターフェイスエディター、もう一方の側にコードエディターが表示されます。
Xcode によりコードエディターで自動的に ViewController.m ファイルが選択されたことに注意してください。これは間違っています。前述の Outlet と Action とは何かについての説明のように、開発者は ViewController.h を選択する必要があります。
コードエディターの上部で、[自動リンク] をクリックし、ViewController.h ファイルを選択します。
Xcode で正しいファイルが選択されます。
最後のステップは非常に重要です。正しいファイルを選択しなかった場合、Outlet と Action を作成することができなくなるか、またはそれらが C# の間違ったクラスに公開されます。
インターフェイスエディターで、キーボードの Control キーを押しながら、前述の手順で作成したラベルをクリックしてコードエディターの @interface ViewController : NSViewController {} コードのすぐ下にドラッグします。
ダイアログボックスが表示されます。 [接続] を [アウトレット] に設定したままにして、[名前]に「ClickedLabel」と入力します。
[接続] ボタンをクリックしてアウトレットを作成します。
変更をファイルに保存します。

アクションの追加

次に、ボタンを C# コードに公開します。上記のラベルと同じように、開発者はボタンをアウトレットに接続できます。クリックされたボタンにのみ応答するようにしたいので、代わりにアクションを使用します。

次の操作を行います。

Xcode でアシスタントエディターがまだ開いていて、ViewController.h ファイルがコードエディターに表示されていることを確認します。
インターフェイスエディターで、キーボードの Control キーを押しながら、前述の手順で作成したボタンをクリックしてコードエディターの @property (assign) IBOutlet NSTextField *ClickedLabel; コードのすぐ下にドラッグします。
[接続] の種類を [アクション] に変更します。
[名前] に「ClickedButton」を入力します。
[接続] ボタンをクリックしてアクションを作成します。
変更をファイルに保存します。

ユーザーインターフェイスを接続して C# コードに公開したので、Visual Studio for Mac に戻り、Xcode と Interface Builder で行った変更を同期させます。

Note

この最初のアプリのユーザーインターフェイスおよび Outlet と Action を作成するには時間がかかったことでしょう。作業量が多いように思われるかもしれませんが、多くの新しい概念が導入されているため、時間をかけて新しい作業方法を紹介しました。 Interface Builder を使用してしばらく練習すれば、このインターフェイスおよびすべての Outlet と Action をわずか 1、2 分で作成できるようになります。

Xcode との変更の同期

開発者が Xcode から Visual Studio for Mac に戻ると、Xcode で行った変更は自動的に Xamarin.Mac プロジェクトと同期されます。

ソリューションエクスプローラーで ViewController.designer.cs を選択して、Outlet と Action が C# コードでどのように接続されているかを確認します。

ViewController.designer.cs ファイル内の 2 つの定義がどのようになっているかに注目してください。

[Outlet]
AppKit.NSTextField ClickedLabel { get; set; }

[Action ("ClickedButton:")]
partial void ClickedButton (Foundation.NSObject sender);

Xcode の ViewController.h ファイルの定義と比べてみましょう。

@property (assign) IBOutlet NSTextField *ClickedLabel;
- (IBAction)ClickedButton:(id)sender;

Visual Studio for Mac は .h ファイルの変更をリッスンし、それぞれの .designer.cs ファイルでこれらの変更を自動的に同期して、アプリに公開します。 ViewController.designer.cs が部分クラスであるため、Visual Studio for Mac は、開発者がクラスに対して行った変更を上書きする ViewController.cs を変更する必要がないことに注意してください。

通常、開発者は ViewController.designer.cs を開く必要はありませんが、ここでは学習の目的のためだけに示しています。

Note

ほとんどの場合、Visual Studio for Mac は Xcode で行われた変更を自動的に確認し、Xamarin.Mac プロジェクトに同期します。同期が自動的に行われないときは Xcode に戻り、再び Visual Studio for Mac に戻ります。こうすると通常、同期サイクルが開始します。

コードの記述

ユーザーインターフェイスが作成され、UI 要素が Outlet と Action を介してコードに公開されたので、最終的にプログラムを実現するためのコードを書く準備が整いました。

このサンプルアプリでは、最初のボタンをクリックするたびにラベルが更新され、ボタンがクリックされた回数が表示されます。これを行うには、ソリューションエクスプローラーで ViewController.cs ファイルをダブルクリックして編集用に開きます。

まず、ViewController クラスにクラスレベル変数を作成して、発生したクリックの回数を追跡します。クラス定義を編集し、次のようにします。

namespace Hello_Mac
{
    public partial class ViewController : NSViewController
    {
        private int numberOfTimesClicked = 0;
        ...

次に、同じクラス (ViewController) で、ViewDidLoad メソッドをオーバーライドし、ラベルの初期メッセージを設定するコードを追加します。

public override void ViewDidLoad ()
{
    base.ViewDidLoad ();

    // Set the initial value for the label
    ClickedLabel.StringValue = "Button has not been clicked yet.";
}

ViewDidLoad (Initialize などの別のメソッドではなく) を使用します。ViewDidLoad は、OS が読み込まれ、.storyboard ファイルからユーザーインターフェイスがインスタンス化された後に呼び出されるためです。 .storyboard ファイルが完全に読み込まれてインスタンス化される前に開発者がラベルコントロールにアクセスしようとすると、ラベルコントロールがまだ存在しないため NullReferenceException エラーが発生します。

次に、ボタンをクリックしたユーザーに応答するコードを追加します。次の部分メソッドを ViewController クラスに追加します。

partial void ClickedButton (Foundation.NSObject sender) {
    // Update counter and label
    ClickedLabel.StringValue = string.Format("The button has been clicked {0} time{1}.",++numberOfTimesClicked, (numberOfTimesClicked < 2) ? "" : "s");
}

このコードは、Xcode と Interface Builder で作成されたアクションにアタッチされ、ユーザーがボタンをクリックするたびに呼び出されます。

アプリケーションのテスト

アプリをビルドして実行し、期待どおりに動作することを確認します。開発者は 1 つのステップですべてをビルドして実行することも、実行せずビルドすることもできます。

アプリのビルド時、開発者はビルドの種類を選択できます。

デバッグ – デバッグビルドは、アプリの実行中に何が起きているのかを開発者がデバッグすることを可能にする追加のメタデータを含む .app (アプリケーション) ファイルにコンパイルされます。
リリース – リリースビルドでは、.app ファイルも作成されますが、デバッグ情報は含まれていないためサイズが小さく、高速に実行されます。

開発者は、Visual Studio for Mac 画面の左上隅にある構成セレクターからビルドの種類を選択できます。

アプリケーションのビルド

この例ではデバッグビルドで十分なので、[デバッグ] が選択されていることを確認してください。 ⌘B を押すか、[ビルド] メニューの [すべてビルド] を選択して、最初にアプリをビルドします。

エラーがなければ、Visual Studio for Mac のステータスバーに "ビルドが成功しました" というメッセージが表示されます。エラーがあった場合はプロジェクトを見直し、上記の手順に正しく従っていることを確認してください。まず、コード (Xcode と Visual Studio for Mac の両方) がチュートリアルのコードと一致していることを確認します。

アプリケーションの実行

アプリを実行するには次の 3 つの方法があります。

⌘+Enter を押します。
[実行] メニューの [デバッグ] を選択します。
Visual Studio for Mac ツールバー (ソリューションエクスプローラーのすぐ上) の [再生] ボタンをクリックします。

アプリはビルド (まだビルドされていない場合)、デバッグモードで起動し、メインインターフェイスウィンドウを表示します。

ボタンが何回かクリックさると、ラベルのカウントが更新されます。

次の場所

Xamarin.Mac アプリケーションの操作の基礎をより深く理解するために、次のドキュメントを参照してください。

Introduction to Storyboards (ストーリーボードの概要) - この記事では、Xamarin.Mac アプリでのストーリーボードの使用について紹介しています。ストーリーボードと Xcode の Interface Builder を使用したアプリの UI の作成と維持管理に関する内容が含まれています。
Window (ウィンドウ) - この記事では、Xamarin.Mac アプリケーションでのウィンドウとパネルの使用について説明しています。 Xcode とインターフェイスビルダーでのウィンドウとパネルの作成と維持管理、.xib ファイルからのウィンドウとパネルの読み込み、C# コードでのウィンドウの使用とウィンドウへの応答に関する内容が含まれています。
Dialogs (ダイアログ) - この記事では、Xamarin.Mac アプリケーションでのダイアログとモーダルウィンドウの使用について説明しています。 Xcode とインターフェイスビルダーでのモーダルウィンドウの作成と維持管理、標準ダイアログの使用、C# コードでのウィンドウの表示とウィンドウへの応答に関する内容が含まれています。
Alerts (アラート) - この記事では、Xamarin.Mac アプリケーションでのアラートの使用について説明しています。 C# コードからのアラートの作成と表示、アラートへの応答に関する内容が含まれています。
Menus (メニュー) - メニューは、Mac アプリケーションのユーザーインターフェイスのさまざまな部分で使用されます (画面上部にあるアプリケーションのメインメニューから、ウィンドウ内のどこにでも表示されるポップアップメニューとコンテキストメニューまで)。メニューは、Mac アプリケーションのユーザーエクスペリエンスにとって不可欠な部分です。この記事では、Xamarin.Mac アプリケーションでの Cocoa メニューの使用について説明しています。
Toolbars (ツールバー) - この記事では、Xamarin.Mac アプリケーションでのツールバーの使用について説明しています。ここでは作成と維持について説明します。 Xcode と Interface Builder でのツールバー、Outlet と Action を使用してツールバー項目をコードに公開する方法、ツールバー項目の有効化と無効化、最後に C# コードでのツールバー項目への応答に関する内容が含まれています。
Table Views (テーブルビュー) - この記事では、Xamarin.Mac アプリケーションでのテーブルビューの使用について説明しています。 Xcode とインターフェイスビルダーでのテーブルビューの作成と維持管理、Outlet と Action を使用してテーブルビュー項目をコードに公開する方法、テーブルビュー項目の設定、最後に C# コードでのテーブルビュー項目への応答に関する内容が含まれています。
Outline View (アウトラインビュー) - この記事では、Xamarin.Mac アプリケーションでのアウトラインビューの使用について説明しています。 Xcode とインターフェイスビルダーでのアウトラインビューの作成と維持管理、Outlet と Action を使用してアウトラインビュー項目をコードに公開する方法、アウトラインビュー項目の設定、最後に C# コードでのアウトラインビュー項目への応答に関する内容が含まれています。
Source Lists (ソースリスト) - この記事では、Xamarin.Mac アプリケーションでのソースリストの使用について説明しています。 Xcode とインターフェイスビルダーでのソースリストの作成と維持管理、Outlet と Action を使用してソースリスト項目をコードに公開する方法、ソースリスト項目の設定、最後に C# コードでのソースリスト項目への応答に関する内容が含まれています。
Collection Views (コレクションビュー) - この記事では、Xamarin.Mac アプリケーションでのコレクションビューの使用について説明しています。 Xcode とインターフェイスビルダーでのコレクションビューの作成と維持管理、Outlet と Action を使用してコレクションビュー項目をコードに公開する方法、コレクションビューの設定、最後に C# コードでのコレクションビューへの応答に関する内容が含まれています。
イメージの処理 - この記事では、Xamarin.Mac アプリケーションでの画像の使用について説明しています。アプリのアイコンを作成するために必要な画像の作成と維持管理、C# コードと Xcode の Interface Builder の両方での画像の使用に関する内容が含まれています。

Mac サンプルギャラリーには、Xamarin.Mac の学習に役立つすぐに使用できるコード例が含まれています。

ユーザーが一般的な Mac アプリケーションに期待する機能を多数含んでいる完全な Xamarin.Mac アプリの 1 つが、SourceWriter サンプルアプリです。 SourceWriter は、コードの完了とシンプルな構文の強調表示をサポートするシンプルなソースコードエディターです。

SourceWriter のコード全体に詳細なコメントが付いており、また利用可能な場合には、重要な技術やメソッドから Xamarin.Mac ドキュメントの関連情報まで、さまざまなリンクが用意されています。

まとめ

この記事では、標準的な Xamarin.Mac アプリの基本について説明しています。 Visual Studio for Mac での新しいアプリの作成、Xcode と Interface Builder でのユーザーインターフェイスのデザイン、Outlet と Action を使用して UI 要素を C# コードに公開する方法、UI 要素と連携するようにコードを追加する方法、最後に Xamarin.Mac アプリのビルドとテストに関する内容が含まれます。

macOS ヒューマンインターフェイスガイドライン

Hello, Mac – チュートリアル

要件

Visual Studio for Mac で新しい Xamarin.Mac アプリを起動する

Xamarin.Mac アプリケーションの構造

Main.cs

AppDelegate.cs

ViewController.cs

ViewController.Designer.cs

Info.plist

Entitlements.plist

Xcode と Interface Builder の概要

Xcode のコンポーネント

プロジェクトのナビゲーション

インターフェイス階層

インターフェイスエディター

プロパティとユーティリティ

プロパティとユーティリティの種類

インターフェイスの作成

Outlet と Action

アウトレットの追加

アクションの追加

Xcode との変更の同期

コードの記述

アプリケーションのテスト

アプリケーションのビルド

アプリケーションの実行

次の場所

まとめ

その他のリソース

Hello, Mac – チュートリアル

要件

Visual Studio for Mac で新しい Xamarin.Mac アプリを起動する

Xamarin.Mac アプリケーションの構造

Main.cs

AppDelegate.cs

ViewController.cs

ViewController.Designer.cs

Info.plist

Entitlements.plist

Xcode と Interface Builder の概要

Xcode のコンポーネント

プロジェクトのナビゲーション

インターフェイス階層

インターフェイス エディター

プロパティとユーティリティ

プロパティとユーティリティの種類

インターフェイスの作成

Outlet と Action

アウトレットの追加

アクションの追加

Xcode との変更の同期

コードの記述

アプリケーションのテスト

アプリケーションのビルド

アプリケーションの実行

次の場所

まとめ

関連リンク

その他のリソース

インターフェイスエディター