2024年 3月の投稿一覧

Windows 環境において Linux コマンドを用いて作業したいときなどには基本的に WSL2 を使うことが多いのだが、WSL2 は仮想マシンなのでネットワーク周りが不便なこともあり、それ単体だけではどうしても都合が悪いこともあったりするので、開発作業時などでは Git-bash に付属している mingw を併用して凌いだりしている。

個人的には、 Git-bash に付属する mingw を Windows Terminal (wt.exe) 内で起動して、見た目を Ubuntu に寄せるような設定を適用して利用している。

~/.bashrc

言語設定や不便な点の解消をするための設定の寄せ集めの記述がメイン。

##### language settings
export LC_ALL=ja_JP.utf8
export LANG=ja_JP.utf8
export LANGUAGE=ja_JP.utf8
export LC_CTYPE="ja_JP.utf8"
export LC_NUMERIC="ja_JP.utf8"
export LC_TIME="ja_JP.utf8"
export LC_COLLATE="ja_JP.utf8"
export LC_MONETARY="ja_JP.utf8"
export LC_MESSAGES="ja_JP.utf8"

##### ls color
eval "$(dircolors /etc/DIR_COLORS -b)"
alias ls='ls --color=auto'

##### unblock Control + S
stty stop undef

~/.config/git/git-prompt.sh

プロンプトのカスタマイズ。
Ubuntu と完全に同一にしてしまうと、自分がどのシェルソフトウェアを使っているかわからなくなるので、Windows っぽい目印 (❖) を含めている (仮想マシンじゃなくて互換レイヤを使っているよってことで)。

##### PROMPT SETTINGS
PS1='\[\033]0;$PWD\007\]' # window title
PS1="$PS1"'\[\033[01;32m\]\u@❖ \h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '

~/.inputrc

プロンプトに何も入力してない状態で Backspace を押したときなどでベルが鳴る操作をすると、ターミナルウィンドウが明滅してしまう。その抑制設定。

# suppress flashing window for wt.exe
set bell-style audible

Claris Filemaker に組み込んで利用するためのプラグインの作成について。
プラグイン環境構築からコンパイルまで。

開発環境および SDK について

SDK の入手

Claris 社からサンプルプロジェクトが配布されている。
https://www.claris.com/ja/resources/downloads/ の画面下部スポイラー「プラグインのサポート」の中に、SDK のダウンロードリンクが張ってある。SDK に変更が加わるごとにダウンロードできるファイルも更新されるようなので、最新版が出てないか時々ダウンロードするとよい。

コンパイラについて

SDK に含まれているサンプルプロジェクトには、 Visual Studio 向けのプロジェクトファイル (.sln) と Code::Blocks 向けのプロジェクトファイル (.cbp) が同梱されている。

開発には C++ を利用するため、上記の IDE および C++ 向けのコンパイラを用意しておく必要がある。
私の手元の開発環境には Visual Studio がインストールされているので、以降の説明は Visual Studio 向け。

SDK 構成について

Headers/FMWrapper

Filemaker の内部で利用されている型や API や定数値をまとめたヘッダファイル群。ここでは細かく解説しない (機会があれば別のところで) が、特に大事なファイルは FMXExtern.h である。(プラグインのエントリポイント関数のシグネチャについて記述されている)

Libraries

各環境 (OS) 向けのライブラリが存在する。中身までは詳しく見ていないが、名前からして Headers/FMWrapper のヘッダに対応した本体のバイナリであると思われる。

MiniExample

プラグインのサンプルプロジェクト。

コンパイルについて

MSBuild から

FMMiniPlugin.sln が存在するディレクトリ内で、 MSBuild.exe コマンドを発行する。手元で試したところ、 x64/Debug/FMMiniPlugin.fmx64 ファイルが出力された。これがプラグインファイルである。

MSBuild コマンドに対してオプションを指定することによって、 Debug/Release や x86/x64 向けなどのビルド構成を指示できる。

> MSBuild.exe
MSBuild のバージョン 17.9.5+33de0b227 (.NET Framework)
2024/03/18 5:41:56 にビルドを開始しました。

ノード 1 上のプロジェクト "C:\xxxxx\PlugInSDK\MiniExample\FMMiniPlugIn.sln" ( 既定のターゲット)。"
  ソリューション構成 "Debug|x64" をビルドしています。
PrepareForBuild:
  構造化出力が有効になっています。コンパイラ診断の書式設定にはエラー階層が反映されます。詳細については、https://aka.ms/cpp/structured-output を参照してください。
InitializeBuildStatus:
  "AlwaysCreate" が指定されたため "x64\Debug\FMMiniPlugIn.tlog\unsuccessfulbuild" を作成しています。
  "x64\Debug\FMMiniPlugIn.tlog\unsuccessfulbuild" のタッチ タスクを実行しています。
ClCompile:
  すべての出力が最新のものです。
ResourceCompile:
  すべての出力が最新のものです。
Link:
  すべての出力が最新のものです。
  FMMiniPlugIn.vcxproj -> C:\xxxxx\PlugInSDK\MiniExample\x64\Debug\FMMiniPlug
  In.fmx64
FinalizeBuildStatus:
  ファイル "x64\Debug\FMMiniPlugIn.tlog\unsuccessfulbuild" を削除しています。
  "x64\Debug\FMMiniPlugIn.tlog\FMMiniPlugIn.lastbuildstate" のタッチ タスクを実行しています。
プロジェクト "C:\xxxxx\PlugInSDK\MiniExample\FMMiniPlugIn\FMMiniPlugIn.vcxproj" (既定
のターゲット) のビルドが完了しました。

プロジェクト "C:\xxxxx\PlugInSDK\MiniExample\FMMiniPlugIn.sln" (既定のターゲット) のビルドが完了しま
した。

ビルドに成功しました。
    0 個の警告
    0 エラー

経過時間 00:00:00.26

Visual Studio (IDE) から

FMMiniPlugin.sln ファイルを Visual Studio から開く。Ctrl + Shift + B キー押下でビルドを実行すると、 x64/Debug/FMMiniPlugin.fmx64 ファイルが出力される。

まとめ

本記事では、提供元からサンプルプロジェクトをダウンロードしてきて、手元でコンパイルを実行するまでの手順を並べた。

実際は、ビルド時に読み込まれるメタデータ (プラグイン発行元など) を編集したり、独自の機能を提供するために C++ コードを記述したりする必要がある。実際のカスタマイズについては、別途解説記事を作成する予定。