WebKitGTK からの移行ガイド

作成者: BlinkGTK Project
最終更新: 2026-07-30

English

WebKitGTK 6.0 (GTK4) のアプリケーションを BlinkGTK に移すためのガイドです。
最短の移行手順を最初に、次に機械的な置換表、API 対応表、設計の違い、
そして「WebKitGTK にあって BlinkGTK に無いもの」を正直に記します。
記載されている BlinkGTK の API はすべて、配布物のヘッダと共有ライブラリに
実在することを機械検証しています。

まず動かす

典型的な WebKitGTK アプリの移行は、コードの変更としては数箇所です。
それに加えて BlinkGTK 固有の準備が 2 つ あります (WebKitGTK には無い手順):

1. リンクは pkg-config 経由が必須 — pkg-config --cflags --libs blinkgtk-0.1。
   手書きリンクだと必要なライブラリの直接リンクが漏れ、起動直後に落ちます
2. Chromium ランタイムリソースの配置 — icudtl.dat や locales/ などが
   実行時に必要です。パッケージ同梱のラッパー run-with-resources を使うか、
   blink_gtk_set_resources_path() で場所を指定します

いずれも アプリのビルド に完全な手順があります。

Before — WebKitGTK 6.0

#include <webkit/webkit.h>
#include <gtk/gtk.h>

int main(int argc, char *argv[])
{
    gtk_init();

    GtkWidget *window = gtk_window_new();
    gtk_window_set_title(GTK_WINDOW(window), "WebKitGTK Browser");
    gtk_window_set_default_size(GTK_WINDOW(window), 1024, 768);

    WebKitWebView *web_view = WEBKIT_WEB_VIEW(webkit_web_view_new());
    gtk_window_set_child(GTK_WINDOW(window), GTK_WIDGET(web_view));

    webkit_web_view_load_uri(web_view, "https://example.com/");
    gtk_window_present(GTK_WINDOW(window));

    GMainLoop *loop = g_main_loop_new(NULL, FALSE);
    g_main_loop_run(loop);
    return 0;
}

After — BlinkGTK

#include <blink_gtk/blink_gtk.h>
#include <gtk/gtk.h>

int main(int argc, char *argv[])
{
    /* 変更 1: エンジンの初期化を GTK より先に */
    if (!blink_gtk_init(&argc, &argv)) {
        g_printerr("blink_gtk_init() failed\n");
        return 1;
    }
    gtk_init();

    GtkWidget *window = gtk_window_new();
    gtk_window_set_title(GTK_WINDOW(window), "BlinkGTK Browser");
    gtk_window_set_default_size(GTK_WINDOW(window), 1024, 768);

    /* 変更 2: WebView 作成。戻り値は GtkWidget* なのでキャスト不要で子にできる */
    GtkWidget *web_view = blink_web_view_new();
    gtk_window_set_child(GTK_WINDOW(window), web_view);

    /* 変更 3: BlinkGTK API へ渡すときは BLINK_WEB_VIEW() でキャスト */
    blink_web_view_load_uri(BLINK_WEB_VIEW(web_view), "https://example.com/");
    gtk_window_present(GTK_WINDOW(window));

    /* 変更 4: メインループは BlinkGTK のものを使う */
    int status = blink_gtk_run_main_loop();

    /* 変更 5: 終了処理 */
    blink_gtk_shutdown();
    return status;
}

ビルドコマンドの変更

# Before
cc app.c -o app $(pkg-config --cflags --libs gtk4 webkitgtk-6.0)

# After
cc app.c -o app $(pkg-config --cflags --libs blinkgtk-0.1)

機械的な置換 (チェックリスト)

• #include <webkit/webkit.h> → #include <blink_gtk/blink_gtk.h>
• gtk_init() の前に blink_gtk_init(&argc, &argv) を追加
• メインループを blink_gtk_run_main_loop() / blink_gtk_quit_main_loop() に
• 終了処理に blink_gtk_shutdown() を追加
• webkit_web_view_new() → blink_web_view_new() (戻り値は GtkWidget*)
• WEBKIT_WEB_VIEW(x) → BLINK_WEB_VIEW(x)
• webkit_web_view_load_uri() → blink_web_view_load_uri()
• webkit_web_view_get_settings() の呼び出しを削除 (設定は WebView に直接。下記)
• pkg-config のパッケージ名を webkitgtk-6.0 → blinkgtk-0.1
• 実行時リソースの配置 (アプリのビルド 参照)

API 対応表

設定 (WebKitSettings 相当)

BlinkGTK には Settings オブジェクトがありません。設定は WebView に直接行います。

各 set_* に対応する get_* も同様にあります。詳細:
Settings API

ナビゲーション

詳細: Navigation API

シグナル

詳細: Signals API

ページとの対話

詳細: アプリ連携 API

UI のカスタマイズ

詳細: UI ハンドラ API

その他の機能

目的から探す場合は 逆引きリファレンス が便利です。

考え方が変わるところ

1. Settings / Manager / Controller オブジェクトが無い — WebKitGTK では
   webkit_web_view_get_settings() などで補助オブジェクトを取得してから操作しますが、
   BlinkGTK ではすべて WebView に直接 API を呼びます
2. 型は GtkWidget* — blink_web_view_new() は GtkWidget* を返します。
   GTK の API にはそのまま渡し、BlinkGTK の API には BLINK_WEB_VIEW() でキャストして渡します
3. 初期化順序が厳密 — blink_gtk_init() を GTK より先に呼びます
   (ライフサイクル図 参照)
4. 実行時リソースの配置が必要 — Chromium 由来のデータファイル群が実行時に要ります。
   WebKitGTK には無い手順なので、移行時に最初に確認してください
5. Wayland セッション必須 — BlinkGTK は Wayland 専用です。X11 のみの環境では
   動作しません (WebKitGTK は X11 でも動くため、ここは明確な差です)
6. 開発ツールは Chrome DevTools — WebInspector の代わりに、リモートデバッグを含む
   Chrome DevTools が使えます (DevTools API)

WebKitGTK にあって BlinkGTK に (まだ) 無いもの

正直に書きます。以下は現時点で相当機能がありません。

• WebExtensions (WebProcess 内拡張の仕組み)
• WebKitWebContext / WebKitNetworkSession 相当の直接操作 — プロキシ設定、
  キャッシュ制御、独自のデータディレクトリ指定など
• 印刷ダイアログ — blink_web_view_print_to_pdf() による PDF 出力のみ
• 編集コマンド (webkit_web_view_execute_editing_command() 相当)

これらが移行の妨げになる場合は、
不具合報告・要望 または
contact@blinkgtk.org までお知らせください。

よくある質問

WebKitGTK と BlinkGTK を同じプロセスで使えますか

推奨しません。どちらも大きなランタイムを持つため、メモリ使用量が増えるほか、
シンボルやメインループの取り合いなど予期しない干渉の恐れがあります。

パフォーマンスはどうですか

JavaScript は V8、描画は Chromium のパイプラインで実行されます。静止中のページで
CPU をほぼ消費しない設計です。一方、Chromium 系はメモリ使用量が WebKit より
多くなる傾向があります。用途に応じて評価してください
(詳細: エンジン比較)。

X11 環境でも動きますか

動きません。Wayland セッションが必須です。

移行はどこから始めるべきですか

このページの「まず動かす」の After のコードを、そのまま
アプリのビルド の手順でビルドして動かしてから、
自分のアプリの置換に進むのが確実です。

関連

• アプリのビルド — リンク方法・リソース配置の完全な手順
• 逆引きリファレンス — 目的から関数を探す
• API 目次
• エンジン比較 — WebKitGTK・CEF との詳細比較

変更履歴