GTK# プラットフォームのセットアップ

[アーティクル]
01/10/2024

Xamarin.Forms 現在、GTK# アプリのプレビューサポートが提供されています。 GTK# は、GTK+ ツールキットとさまざまな GNOME ライブラリをリンクするグラフィカルユーザーインターフェイスツールキットであり、Mono と .NET を使用して完全にネイティブな GNOME グラフィックスアプリを開発できます。この記事では、GTK# プロジェクトをソリューションに追加する方法について Xamarin.Forms 説明します。

重要

Xamarin.Forms GTK# のサポートはコミュニティによって提供されます。詳細については、「プラットフォームのサポート」を参照してください。Xamarin.Forms

開始する前に、新Xamarin.Formsしいソリューションを作成するか、既存Xamarin.Formsのソリューション (GameOfLife など) を使用します。

Note

この記事では、VS2017 および Visual Studio for Mac のソリューションに Xamarin.Forms GTK# アプリを追加することに重点を置いていますが、MonoDevelop for Linux でも実行できます。

GTK# アプリの追加

macOS および Linux 用の GTK# は Mono の一部としてインストールされます。 .NET 用 GTK# は、GTK# インストーラーを使用して Windows にインストールできます。

Visual Studio
Visual Studio for Mac

Windows デスクトップで実行される GTK# アプリを追加するには、次の手順に従います。

Visual Studio 2019 で、ソリューションエクスプローラーのソリューション名を右クリックし、[新しいプロジェクトの追加>]を選択します。
[新しいプロジェクト] ウィンドウの左側にある Visual C# と Windows クラシックデスクトップを選択します。プロジェクトの種類の一覧で[クラスライブラリ (.NET Framework)]を選択し、[フレームワーク] ドロップダウンが最低でも .NET Framework 4.7 に設定されていることを確認します。
プロジェクトの名前を GTK 拡張子で入力します (例: GameOfLife.GTK)。 [参照] ボタンをクリックし、他のプラットフォームプロジェクトを含むフォルダーを選択し、[フォルダーの選択] をクリックします。これにより、GTK プロジェクトがソリューション内の他のプロジェクトと同じディレクトリに配置されます。

[OK] ボタンを押してプロジェクトを作成します。
ソリューションエクスプローラーで、新しい GTK プロジェクトを右クリックし、[NuGet パッケージの管理] を選択します。 [参照] タブを選択し、3.0 以上をXamarin.Forms検索します。

パッケージを選択し、[インストール] ボタンをクリックします。
次に、次を検索します Xamarin.Forms。Platform.GTK 3.0 パッケージ以上。

パッケージを選択し、[インストール] ボタンをクリックします。
ソリューションエクスプローラーで、ソリューション名を右クリックし、[ソリューションの NuGet パッケージの管理] を選択します。 [更新] タブとパッケージをXamarin.Forms選択します。すべてのプロジェクトを選択し、GTK プロジェクトで使用されているのと同じ Xamarin.Forms バージョンに更新します。
ソリューションエクスプローラーで、GTK プロジェクトの [参照] を右クリックします。 [参照マネージャー] ダイアログで、左側にある [プロジェクト] を選択し、.NET Standard または共有プロジェクトの横にあるチェックボックスをチェックします。
[参照マネージャー] ダイアログで、[参照] ボタンを押して C:\Program Files (x86)\GtkSharp\2.12\lib フォルダーを参照し、atk-sharp.dll、gdk-sharp.dll、glade-sharp.dll、glib-sharp.dll、gtk-dotnet.dll、gtk-sharp.dll ファイルを選択します。

[OK] ボタンを押して参照を追加します。
GTK プロジェクトで、Class1.cs の名前を Program.cs に変更します。

GTK プロジェクトで、Program.cs ファイルを次のコードのように編集します。

using System;
using Xamarin.Forms;
using Xamarin.Forms.Platform.GTK;

namespace GameOfLife.GTK
{
    class MainClass
    {
        [STAThread]
        public static void Main(string[] args)
        {
            Gtk.Application.Init();
            Forms.Init();

            var app = new App();
            var window = new FormsWindow();
            window.LoadApplication(app);
            window.SetApplicationTitle("Game of Life");
            window.Show();

            Gtk.Application.Run();
        }
    }
}

このコードは GTK# を初期化し Xamarin.Forms、アプリケーションウィンドウを作成してアプリを実行します。

ソリューションエクスプローラーで、GTK プロジェクトを右クリックし、[プロパティ] を選択します。
[プロパティ] ウィンドウで、[アプリケーション] タブを選択し、[出力の種類] ドロップダウンを [Windows アプリケーション] に変更します。
ソリューションエクスプローラーで GTK プロジェクトを右クリックし、[スタートアッププロジェクトとして設定] を選択します。 F5 キーを押して、Windows デスクトップ上の Visual Studio デバッガーでプログラムを実行します。

Mac デスクトップで実行される GTK# アプリを追加するには、次の手順に従います。

Visual Studio for Mac で、ソリューションをXamarin.Forms右クリックし、[新しいプロジェクトの追加>] を選択します。...
[新しいプロジェクト] ウィンドウで、[その他の > .NET > Gtk# 2.0 プロジェクト] を選択し、[次へ] を押します。
GTK 拡張子を持つプロジェクトの名前 (GameOfLife.GTK など) を入力し、Create キーを押します。
Solution Pad で、GTK プロジェクトの [パッケージ>の追加] を右クリックし、3.0 プレリリース NuGet パッケージ以上を追加Xamarin.Formsします。
Solution Pad で、GTK プロジェクトの [パッケージ>の追加... ] を右クリックしXamarin.Forms、[.Platform.GTK 3.0 プレリリース NuGet パッケージ以上。
GTK プロジェクトで使用されているのと同じ Xamarin.Forms バージョンを使用するように、他のプラットフォームプロジェクトを更新します。
ソリューションパッドで、GTK プロジェクトの [参照>の編集]... を右クリックし、プロジェクトへの参照Xamarin.Formsを追加します (.NET Standard または共有プロジェクト)。

次の コードのように、GTK プロジェクトの Program.cs ファイルを編集します。

using System;
using Xamarin.Forms;
using Xamarin.Forms.Platform.GTK;

namespace GameOfLife.GTK
{
    class MainClass
    {
        [STAThread]
        public static void Main(string[] args)
        {
            Gtk.Application.Init();
            Forms.Init();

            var app = new App();
            var window = new FormsWindow();
            window.LoadApplication(app);
            window.SetApplicationTitle("Game of Life");
            window.Show();

            Gtk.Application.Run();
        }
    }
}

このコードは GTK# を初期化し Xamarin.Forms、アプリケーションウィンドウを作成してアプリを実行します。

Solution Pad で GTK プロジェクトを右クリックし、[スタートアッププロジェクトとして設定] を選択します。
Visual Studio for Mac ツールバーで、[スタート] ボタン ([再生] ボタンに似た三角形のボタン) を押してアプリを起動します。

次のステップ

プラットフォーム固有設定

アプリケーションが実行されているプラットフォーム Xamarin.Forms は、XAML またはコードから判断できます。これにより、GTK# で実行されているときにプログラムの特性を変更できます。コードで、定数 (文字列 "GTK" と等しい) と値を比較Device.RuntimePlatformDevice.GTKします。一致するものがある場合、アプリケーションは GTK# で実行されています。

XAML では、タグを OnPlatform 使用して、プラットフォームに固有のプロパティ値を選択できます。

<Button.TextColor>
    <OnPlatform x:TypeArguments="Color">
        <On Platform="iOS" Value="White" />
        <On Platform="macOS" Value="White" />
        <On Platform="Android" Value="Black" />
        <On Platform="GTK" Value="Blue" />
    </OnPlatform>
</Button.TextColor>

アプリケーションアイコン

起動時にアプリアイコンを設定できます。

window.SetApplicationIcon("icon.png");

テーマ

GTK# にはさまざまなテーマが用意されており、アプリから Xamarin.Forms 使用できます。

GtkThemes.Init ();
GtkThemes.LoadCustomTheme ("Themes/gtkrc");

ネイティブフォーム

ネイティブフォームを使用すると、 Xamarin.FormsContentPage-derived ページを GTK# プロジェクトを含むネイティブプロジェクトで使用できます。これを実現するには、-derived ページの ContentPageインスタンスを作成し、拡張メソッドを使用してネイティブ GTK# 型に CreateContainer 変換します。

var settingsView = new SettingsView().CreateContainer();
vbox.PackEnd(settingsView, true, true, 0);

ネイティブフォームの詳細については、「ネイティブフォーム」を参照してください。

問題

これはプレビューなので、すべてが運用環境に対応しているわけではないことを期待する必要があります。現在の実装状態については、「状態」を参照し、現在の既知の問題については、「保留中の問題」と「既知の問題」を参照してください。

GTK# プラットフォームのセットアップ

GTK# アプリの追加

次のステップ

プラットフォーム固有設定

アプリケーション アイコン

テーマ

ネイティブ フォーム

問題

その他のリソース

アプリケーションアイコン

ネイティブフォーム