C Sharpの応用 - D-Bus - 版の履歴

Wiki: /* D-Busの呼び出し (クライアント側) */

2024-03-02T07:36:35Z

D-Busの呼び出し (クライアント側)

← 古い版		2024年3月2日 (土) 16:36時点における版
84行目:		84行目:
	<br>		<br>
	<u>※注意</u><br>		<u>※注意</u><br>
	<u>実行アプリケーションは特定のD-~~Busサービスを要求する時、そのD~~-~~Busサービスがまだ実行されていない場合、~~<code>Connection</code>クラスの<code>ActivateServiceAsync</code>メソッドを実行することにより、</u><br>		<u>実行アプリケーションは特定のD-Busサービスを要求する時、該当するD-Busサービスがまだ起動していない場合において、<code>Connection</code>クラスの<code>ActivateServiceAsync</code>メソッドを実行することにより、</u><br>
	<u>指定したD-Busサービス名に対してD-~~Busデーモンにリクエストを送信して、該当サービスがまだ起動していない場合には起動を試みる。~~</u><br>		<u>指定したD-Busサービス名に対してD-Busデーモンにリクエストを送信して、該当サービスの起動を試みる。</u><br>
	<u>これは、D-Busサービスの遅延起動（必要になるまでサービスが起動されない）を可能にするためのものである。</u><br>		<u>これは、D-Busサービスの遅延起動（必要になるまでサービスが起動されない）を可能にするためのものである。</u><br>
	<br>		<br>
	<u>D-Busサービスがオンデマンドで実行されるように設計されている場合に特に有用である。</u><br>		<u>D-Busサービスがオンデマンドで実行されるように設計されている場合に特に有用である。</u><br>
	<u>~~つまり、D~~-Busサービスは使用される必要がある時にのみ起動されるため、リソースの節約に役立つ。</u><br>		したがって<u>、D-Busサービスは使用される必要がある時にのみ起動されるため、リソースの節約に役立つ。</u><br>
	<br>		<br>
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">
	using Tmds.DBus;		using Tmds.DBus;
	using login1.DBus; // org.freedesktop.login1サービスをもとに自動生成されたC#インターフェース		using login1.DBus; // org.freedesktop.login1サービスをもとに自動生成されたC#インターフェース

Wiki: /* D-Busの呼び出し (クライアント側) */

2024-03-02T07:34:38Z

D-Busの呼び出し (クライアント側)

← 古い版		2024年3月2日 (土) 16:34時点における版
82行目:		82行目:
	各バスへの接続は、最初の使用時に自動的に確立される。<br>		各バスへの接続は、最初の使用時に自動的に確立される。<br>
	ただし、ステートフル操作 (<code>Connection.RegisterServiceAsync</code>等) は許可されていない。<br>		ただし、ステートフル操作 (<code>Connection.RegisterServiceAsync</code>等) は許可されていない。<br>
			<br>
			<u>※注意</u><br>
			<u>実行アプリケーションは特定のD-Busサービスを要求する時、そのD-Busサービスがまだ実行されていない場合、<code>Connection</code>クラスの<code>ActivateServiceAsync</code>メソッドを実行することにより、</u><br>
			<u>指定したD-Busサービス名に対してD-Busデーモンにリクエストを送信して、該当サービスがまだ起動していない場合には起動を試みる。</u><br>
			<u>これは、D-Busサービスの遅延起動（必要になるまでサービスが起動されない）を可能にするためのものである。</u><br>
			<br>
			<u>D-Busサービスがオンデマンドで実行されるように設計されている場合に特に有用である。</u><br>
			<u>つまり、D-Busサービスは使用される必要がある時にのみ起動されるため、リソースの節約に役立つ。</u><br>
	<br>		<br>
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">
101行目:		109行目:
	// connection.CreateProxy<<自動生成されたインターフェース名>>("<D-Busサービス名>", new ObjectPath("<D-Busオブジェクト名"));		// connection.CreateProxy<<自動生成されたインターフェース名>>("<D-Busサービス名>", new ObjectPath("<D-Busオブジェクト名"));
	var loginManager = connection.CreateProxy<IManager>("org.freedesktop.login1", new ObjectPath("/org/freedesktop/login1"));		var loginManager = connection.CreateProxy<IManager>("org.freedesktop.login1", new ObjectPath("/org/freedesktop/login1"));

			// D-Busサービスのヘルパーファイルが起動していない場合、ヘルパーファイルを起動する
			// 常に起動しているD-Busサービスにおいては不要である
			//await connection.ActivateServiceAsync("<D-Busサービス名>");

	// セッションのリストを取得		// セッションのリストを取得

Wiki: /* D-Busヘルパーファイルのサンプルコード */

2024-03-02T07:26:09Z

D-Busヘルパーファイルのサンプルコード

← 古い版		2024年3月2日 (土) 16:26時点における版
132行目:		132行目:
	# D-Busサービスを登録する。		# D-Busサービスを登録する。
	#: <code>Connection</code>クラスの<code>RegisterServiceAsync</code>メソッド		#: <code>Connection</code>クラスの<code>RegisterServiceAsync</code>メソッド
	~~# サービスを消費するアプリケーションの場合は、<code>ActivateServiceAsync</code>メソッドを実行する。~~
	~~#: <code>Connection</code>クラスの<code>ActivateServiceAsync</code>メソッド~~
	# D-Busサービスが呼び出されてヘルパーファイルが実行されるまで待機する。<br>また、一定時間内に呼び出しが無い場合は、D-Busサービスを終了することを推奨する。		# D-Busサービスが呼び出されてヘルパーファイルが実行されるまで待機する。<br>また、一定時間内に呼び出しが無い場合は、D-Busサービスを終了することを推奨する。
	#: 一定時間のみ待機する場合 (例: 30[Sec])		#: 一定時間のみ待機する場合 (例: 30[Sec])
215行目:		213行目:
	const string helperServiceName = "com.example.MyObject";		const string helperServiceName = "com.example.MyObject";
	await connection.RegisterServiceAsync(helperServiceName);		await connection.RegisterServiceAsync(helperServiceName);

	~~// D-Busサービスを有効化~~
	~~await connection.ActivateServiceAsync("com.example.MyObject");~~

	Console.WriteLine("D-Bus server is start.");		Console.WriteLine("D-Bus server is start.");

Wiki: /* D-Busヘルパーファイルのサンプルコード */

2024-03-02T07:18:35Z

D-Busヘルパーファイルのサンプルコード

@@ 125行目: / 125行目: @@
 == D-Busヘルパーファイル ==
 ==== D-Busヘルパーファイルのサンプルコード ====
 以下の例で使用しているD-Busヘルパーファイルのインターフェースは、以下に示すような構造をしている。<br>
   <syntaxhighlight lang="xml">

Wiki: /* D-Busヘルパーファイルのサンプルコード */

2024-03-02T06:48:58Z

D-Busヘルパーファイルのサンプルコード

← 古い版		2024年3月2日 (土) 15:48時点における版
153行目:		153行目:
	}		}

	// D-~~Busオブジェクトの定義~~		// D-Busサービスの定義
	public class MyObject : IMyInterface		public class MyObject : IMyInterface
	{		{
223行目:		223行目:
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>

	==== D-Busセッションバスを使用する場合 ====		==== D-Busセッションバスを使用する場合 ====
	セッションバス向けD-Busサービスファイルを作成する。<br>		セッションバス向けD-Busサービスファイルを作成する。<br>

Wiki: /* サンプルコード */

2024-03-02T06:47:08Z

サンプルコード

差分を表示

Wiki: /* サンプルコード */

2024-02-11T21:42:24Z

サンプルコード

← 古い版		2024年2月12日 (月) 06:42時点における版
75行目:		75行目:
	== サンプルコード ==		== サンプルコード ==
	以下の例では、Linuxにおいてセッションをログオフしている。<br>		以下の例では、Linuxにおいてセッションをログオフしている。<br>
			<br>
			システムバスまたはセッションバスに接続する<code>Connection.System</code>は<code>Static</code>であることに注意する。<br>
			<code>Connection.System</code>および<code>Connection.Session</code>は、それぞれシステムバスおよびセッションバスへの接続を提供する。<br>
			これらのメンバは、アプリケーション全体で同じ<code>Connection</code>クラスを共有する便利な方法を提供している。<br>
			<br>
			各バスへの接続は、最初の使用時に自動的に確立される。<br>
			ただし、ステートフル操作 (<code>Connection.RegisterServiceAsync</code>等) は許可されていない。<br>
	<br>		<br>
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">
88行目:		95行目:
	try		try
	{		{
	// ~~DBusのシステムバスに接続~~		// D-Busのシステムバスに接続
	var connection = Connection.System;		var connection = Connection.System;

	// ログインマネージャーオブジェクトを取得		// ログインマネージャーオブジェクトを取得
			// connection.CreateProxy<<自動生成されたインターフェース名>>("<D-Busサービス名>", new ObjectPath("<D-Busオブジェクト名"));
	var loginManager = connection.CreateProxy<IManager>("org.freedesktop.login1", new ObjectPath("/org/freedesktop/login1"));		var loginManager = connection.CreateProxy<IManager>("org.freedesktop.login1", new ObjectPath("/org/freedesktop/login1"));

Wiki: /* Tmds DBusライブラリのインストール */

2024-02-11T21:34:27Z

Tmds DBusライブラリのインストール

← 古い版		2024年2月12日 (月) 06:34時点における版
10行目:		10行目:
	<br><br>		<br><br>

	== Tmds DBusライブラリのインストール ==		== Tmds.DBus.Protocol ==
			Tmds.DBus.Protocolパッケージは、D-Busプロトコルの低レベルAPIを提供する。<br>
			高レベルのTmds.DBusライブラリとは異なり、プロトコルライブラリはネイティブAOTコンパイルで使用できる。<br>
			<br>
			Tmds.DBus.SourceGeneratorは、プロトコルライブラリをターゲットとしたソースジェネレータを提供する。<br>
			<br><br>

			== Tmds.DBusライブラリのインストール ==
	Tmds.DBusライブラリをNuGetからインストールする。<br>		Tmds.DBusライブラリをNuGetからインストールする。<br>
	また、Tmds.DBusライブラリは[https://github.com/tmds/Tmds.DBus Github]で公開されている。<br>		また、Tmds.DBusライブラリは[https://github.com/tmds/Tmds.DBus Github]で公開されている。<br>
17行目:		24行目:
	*# メイン画面下部にNuGetペインが開くので、<u>Tmds.DBus</u>と入力して検索する。		*# メイン画面下部にNuGetペインが開くので、<u>Tmds.DBus</u>と入力して検索する。
	*# メイン画面右下から、プロジェクト名の右にある[+]ボタンを押下する。		*# メイン画面右下から、プロジェクト名の右にある[+]ボタンを押下する。
	*: Tmds.DBusライブラリがインストールされる。		*# Tmds.DBusライブラリがインストールされる。
	<br>		<br>
	次に、<code>dotnet</code>コマンドを実行して、Tmds.DBus.Toolをインストールする。<br>		次に、<code>dotnet</code>コマンドを実行して、Tmds.DBus.Toolをインストールする。<br>
			これにより、各D-BusサービスからC#のインターフェースを自動生成することができる。<br>
			<br>
	<u>NuGetからインストールする場合、インストールに失敗することに注意する。</u><br>		<u>NuGetからインストールする場合、インストールに失敗することに注意する。</u><br>
	dotnet tool install -g Tmds.DBus.Tool		dotnet tool install -g Tmds.DBus.Tool

Wiki: /* 概要 */

2024-02-11T21:31:45Z

概要

← 古い版		2024年2月12日 (月) 06:31時点における版
1行目:		1行目:
	== 概要 ==		== 概要 ==
	~~dbus~~-~~sharp (ndesk-dbusプロジェクトのフォーク) は、Monoと.NET 2.0をターゲットとするC#の実装である。~~<br>		D-Busはメッセージバスシステムであり、ソフトウェアが互いに通信するためのシンプルな方法である。<br>
			プロセス間通信に加えて、プロセスのライフサイクルを調整するのに役立つ。<br>
			シングルインスタンスのソフトウェアやデーモンをコード化して、そのサービスが必要な時にオンデマンドでソフトウェアやデーモンを起動することにより、シンプルで信頼性の高いものになる。<br>
	<br>		<br>
	Tmds.DBusは、dbus-sharpのプロトコル実装の上に構築されており、.NET 4.5で導入された非同期プログラミングモデルに基づく APIを提供している。<br>		Tmds.DBusは、dbus-sharpのプロトコル実装の上に構築されており、.NET 4.5で導入された非同期プログラミングモデルに基づく APIを提供している。<br>
	このライブラリは .NET Standard 2.0をターゲットとしており、.NET Framework 4.6.1以降、.NET Core / .NET 6以降で実行できる。<br>		このライブラリは .NET Standard 2.0をターゲットとしており、.NET Framework 4.6.1以降、.NET Core / .NET 6以降で実行できる。<br>
			<br>
			dbus-sharp (ndesk-dbusプロジェクトのフォーク) は、Monoと.NET 2.0をターゲットとするC#の実装である。<br>
	<br><br>		<br><br>

Wiki: /* サンプルコード */

2024-02-11T21:28:10Z

サンプルコード

@@ 61行目: / 61行目: @@
 == サンプルコード ==
+以下の例では、Linuxにおいてセッションをログオフしている。<br>
 <br><br>

Wiki: /* D-Busサービスのインターフェースの生成 */

2024-02-11T21:23:03Z

D-Busサービスのインターフェースの生成

← 古い版		2024年2月12日 (月) 06:23時点における版
34行目:		34行目:
	# セッションバスの場合		# セッションバスの場合
	dotnet dbus list objects --bus session --service <D-Busサービス名> \| head -2		dotnet dbus list objects --bus session --service <D-Busサービス名> \| head -2
	<br>		<br>
			以下の例では、org.freedesktop.login1.Managerサービスがシステムバス上にあり、<br>
			org.freedesktop.login1.Managerサービスを実装した/org/freedesktop/login1オブジェクトにエントリポイントオブジェクトがあることを示している。<br>
	# 実行例:		# 実行例:
	dotnet dbus list objects --bus system --service org.freedesktop.login1 \| head -2		dotnet dbus list objects --bus system --service org.freedesktop.login1 \| head -2
41行目:		43行目:
	/org/freedesktop/LogControl1 : org.freedesktop.LogControl1		/org/freedesktop/LogControl1 : org.freedesktop.LogControl1
	/org/freedesktop/login1 : org.freedesktop.login1.Manager		/org/freedesktop/login1 : org.freedesktop.login1.Manager
	~~<br>~~
	~~上記の出力例では、org.freedesktop.login1.Managerサービスがシステムバス上にあり、<br>~~
	~~org.freedesktop.login1.Managerサービスを実装した/org/freedesktop/login1オブジェクトにエントリポイントオブジェクトがあることを示している。<br>~~
	<br>		<br>
	最後に、<code>dotnet dbus codegen</code>コマンドを実行して、D-Busサービス向けのC#インターフェイスを生成する。<br>		最後に、<code>dotnet dbus codegen</code>コマンドを実行して、D-Busサービス向けのC#インターフェイスを生成する。<br>

Wiki: /* D-Busサービスのインターフェースの生成 */

2024-02-11T21:22:27Z

D-Busサービスのインターフェースの生成

← 古い版		2024年2月12日 (月) 06:22時点における版
22行目:		22行目:
	== D-Busサービスのインターフェースの生成 ==		== D-Busサービスのインターフェースの生成 ==
	<code>dotnet dbus list</code>コマンドを実行して、任意のD-Busサービス名を調べる。<br>		<code>dotnet dbus list</code>コマンドを実行して、任意のD-Busサービス名を調べる。<br>
			# システムバスの場合
	dotnet dbus list services --bus system \| grep -iE "<D-Busサービス名 (名前の一部でも可能)>"		dotnet dbus list services --bus system \| grep -iE "<D-Busサービス名 (名前の一部でも可能)>"

			# セッションバスの場合
			dotnet dbus list services --bus session \| grep -iE "<D-Busサービス名 (名前の一部でも可能)>"
	<br>		<br>
	D-Busサービス名を使用して、D-Busオブジェクト名を調べる。<br>		D-Busサービス名を使用して、D-Busオブジェクト名を調べる。<br>
			# システムバスの場合
	dotnet dbus list objects --bus system --service <D-Busサービス名> \| head -2		dotnet dbus list objects --bus system --service <D-Busサービス名> \| head -2

			# セッションバスの場合
			dotnet dbus list objects --bus session --service <D-Busサービス名> \| head -2
	<br>		<br>
	# 実行例:		# 実行例:
38行目:		46行目:
	<br>		<br>
	最後に、<code>dotnet dbus codegen</code>コマンドを実行して、D-Busサービス向けのC#インターフェイスを生成する。<br>		最後に、<code>dotnet dbus codegen</code>コマンドを実行して、D-Busサービス向けのC#インターフェイスを生成する。<br>
			# システムバスの場合
	dotnet dbus codegen --bus system --service <D-Busサービス名>		dotnet dbus codegen --bus system --service <D-Busサービス名>

			# セッションバスの場合
			dotnet dbus codegen --bus session --service <D-Busサービス名>

	# 実行例:		# 実行例:
	dotnet dbus codegen --bus system --service org.freedesktop.login1		dotnet dbus codegen --bus system --service org.freedesktop.login1
	<br>		<br>
	~~これにより、現在のカレントディレクトリに~~<u><D-Busサービス名のサフィックス>.DBus.cs</u>~~ファイルが生成される。~~<br>		C#インターフェイスが記述されているファイルは、現在のカレントディレクトリに<u><D-Busサービス名のサフィックス>.DBus.cs</u>ファイルとして生成される。<br>
	<br>		<br>
	自動生成されたC#ファイルには、D-Busサービスのインターフェースが記述されている。<br>		自動生成されたC#ファイルには、D-Busサービスのインターフェースが記述されている。<br>

Wiki: ページの作成:「== 概要 == dbus-sharp (ndesk-dbusプロジェクトのフォーク) は、Monoと.NET 2.0をターゲットとするC#の実装である。

Tmds.DBusは、dbus-sharpのプロトコル実装の上に構築されており、.NET 4.5で導入された非同期プログラミングモデルに基づく APIを提供している。
このライブラリは .NET Standard 2.0をターゲットとしており、.NET Framework 4.6.1以降、.NET Core / .NET 6…」

2024-02-11T21:19:00Z

ページの作成:「== 概要 == dbus-sharp (ndesk-dbusプロジェクトのフォーク) は、Monoと.NET 2.0をターゲットとするC#の実装である。 Tmds.DBusは、dbus-sharpのプロトコル実装の上に構築されており、.NET 4.5で導入された非同期プログラミングモデルに基づく APIを提供している。 このライブラリは .NET Standard 2.0をターゲットとしており、.NET Framework 4.6.1以降、.NET Core / .NET 6…」

新規ページ

== 概要 ==
dbus-sharp (ndesk-dbusプロジェクトのフォーク) は、Monoと.NET 2.0をターゲットとするC#の実装である。 
 
Tmds.DBusは、dbus-sharpのプロトコル実装の上に構築されており、.NET 4.5で導入された非同期プログラミングモデルに基づく APIを提供している。 
このライブラリは .NET Standard 2.0をターゲットとしており、.NET Framework 4.6.1以降、.NET Core / .NET 6以降で実行できる。 
 

== Tmds DBusライブラリのインストール ==
Tmds.DBusライブラリをNuGetからインストールする。 
また、Tmds.DBusライブラリは[https://github.com/tmds/Tmds.DBus Github]で公開されている。 
* Riderの場合
*# [ツール]メニューバー - [NuGet] - [<プロジェクト名> の NuGet パッケージを管理]を選択する。
*# メイン画面下部にNuGetペインが開くので、Tmds.DBusと入力して検索する。
*# メイン画面右下から、プロジェクト名の右にある[+]ボタンを押下する。
*: Tmds.DBusライブラリがインストールされる。
 
次に、<code>dotnet</code>コマンドを実行して、Tmds.DBus.Toolをインストールする。 
NuGetからインストールする場合、インストールに失敗することに注意する。 
dotnet tool install -g Tmds.DBus.Tool
 

== D-Busサービスのインターフェースの生成 ==
<code>dotnet dbus list</code>コマンドを実行して、任意のD-Busサービス名を調べる。 
dotnet dbus list services --bus system | grep -iE "<D-Busサービス名 (名前の一部でも可能)>"
 
D-Busサービス名を使用して、D-Busオブジェクト名を調べる。 
dotnet dbus list objects --bus system --service <D-Busサービス名> | head -2
 
# 実行例:
dotnet dbus list objects --bus system --service org.freedesktop.login1 | head -2

# 出力例:
/org/freedesktop/LogControl1 : org.freedesktop.LogControl1
/org/freedesktop/login1 : org.freedesktop.login1.Manager
 
上記の出力例では、org.freedesktop.login1.Managerサービスがシステムバス上にあり、 
org.freedesktop.login1.Managerサービスを実装した/org/freedesktop/login1オブジェクトにエントリポイントオブジェクトがあることを示している。 
 
最後に、<code>dotnet dbus codegen</code>コマンドを実行して、D-Busサービス向けのC#インターフェイスを生成する。 
dotnet dbus codegen --bus system --service <D-Busサービス名>

# 実行例:
dotnet dbus codegen --bus system --service org.freedesktop.login1
 
これにより、現在のカレントディレクトリに<D-Busサービス名のサフィックス>.DBus.csファイルが生成される。 
 
自動生成されたC#ファイルには、D-Busサービスのインターフェースが記述されている。 
このD-Busサービスのインターフェースを使用して、プロキシオブジェクトのインスタンスを生成する。 
 

== サンプルコード ==

 

__FORCETOC__
[[カテゴリ:C Sharp]]