Universal Wayland Session Manager - 版の履歴

Pikosip: 和訳の修正(参照実装->リファレンス実装)

2025-06-13T10:19:30Z

和訳の修正(参照実装->リファレンス実装)

← 古い版		2025年6月13日 (金) 19:19時点における版
3行目:		3行目:
	[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。		[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。

	{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、systemdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}		{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、systemdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|リファレンス実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}

	== インストール ==		== インストール ==

Pikosip: 和訳の修正(システムd->systemd)

2025-06-13T10:17:34Z

和訳の修正(システムd->systemd)

← 古い版		2025年6月13日 (金) 19:17時点における版
3行目:		3行目:
	[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。		[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。

	{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、~~システムd~~のアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}		{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、systemdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}

	== インストール ==		== インストール ==

Kgx: 翻訳

2025-02-13T18:01:41Z

翻訳

← 古い版		2025年2月14日 (金) 03:01時点における版
1行目:		1行目:
	[[Category:グラフィカルユーザーインターフェイス]]		[[Category:グラフィカルユーザーインターフェイス]]
	[[en:Universal Wayland Session Manager]]		[[en:Universal Wayland Session Manager]]
	~~The~~ [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] ('''uwsm''') ~~wraps standalone~~ [[Wayland#~~Compositors~~\|Wayland ~~compositors~~]] ~~into a set of~~ [[systemd]] ~~units on the fly. This provides robust session management including environment,~~ [[XDG Autostart]] ~~support, bi-directional binding with login session, and clean shutdown.~~		[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。

			{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、システムdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}
	{{Note\|It is highly recommended to use [[Dbus-broker\|dbus-broker]] as the D-Bus daemon implementation. Among other benefits, it reuses the systemd activation environment instead of having a separate one. This simplifies environment management and allows proper cleanup. The [[D-Bus#Reference_implementation\|reference implementation]]
	is also supported, but it does not allow unsetting vars, so a best effort cleanup is performed by setting them to an empty string instead. The only way to properly clean up the separate environment of the reference D-Bus daemon is to run {{ic\|loginctl terminate-user ""}}.}}

	== ~~Installation~~ ==		== インストール ==

			{{Pkg\|uwsm}} パッケージを[[インストール]]します。
	[[Install]] the {{Pkg\|uwsm}} package.

	== ~~Configuration~~ ==		== 設定 ==

			=== コンポジタによって設定されたサービスの起動通知と変数 ===
	=== Service startup notification and vars set by compositor ===

	{{Note\|~~If managed compositors already set~~ {{ic\|WAYLAND_DISPLAY}} (~~and other useful environment variables~~) ~~into the~~ systemd ~~activation environment, then you can skip this section and you do not need to use~~ {{ic\|uwsm finalize}}.}}		{{Note\|管理されているコンポジタがすでに {{ic\|WAYLAND_DISPLAY}}(およびその他の有用な環境変数)を systemd アクティベーション環境に設定している場合、このセクションをスキップでき、{{ic\|uwsm finalize}} を使用する必要はありません。}}

			現在のコンポジタを見つけるために、Wayland アプリケーションは {{ic\|WAYLAND_DISPLAY}}(または、[[Wayland#Xwayland\|Xwayland]] を通じて実行する場合は {{ic\|DISPLAY}})変数が必要です。そのため、これらの環境変数およびその他の有用な環境変数は、コンポジタがその値を設定した後、systemd/dbus アクティベーション環境に設定する必要があります。
	In order to find the current compositor wayland applications need the {{ic\|WAYLAND_DISPLAY}} (or {{ic\|DISPLAY}} variable, if they are intended to run through [[Wayland#Xwayland\|Xwayland]]). Therefore this and other useful environment variables should be put into the systemd/dbus activation environment once the compositor has set their value.

	~~The command~~ {{ic\|uwsm finalize}} ~~puts~~ {{ic\|WAYLAND_DISPLAY}}, {{ic\|DISPLAY}} ~~and other environment variables listed via the whitespace-separated~~ {{ic\|UWSM_FINALIZE_VARNAMES}} ~~list into the activation environment. Therefore you need to execute this command after the compositor is ready.~~		コマンド {{ic\|uwsm finalize}} は、{{ic\|WAYLAND_DISPLAY}}、{{ic\|DISPLAY}} および {{ic\|UWSM_FINALIZE_VARNAMES}} リストで空白区切りで指定されたその他の環境変数をアクティベーション環境に設定します。したがって、このコマンドはコンポジタが準備完了した後に実行する必要があります。

			コンポジタによって設定された他の変数がアクティベーション環境に必要な場合、それらも引数として渡すことができます:
	If other variables set by the compositors are needed in your activation environment, then you can also pass them as arguments:

	exec uwsm finalize ''VAR1'' ''VAR2'' ''...''		exec uwsm finalize ''VAR1'' ''VAR2'' ''...''

	=== ~~Environment variables~~ ===		=== 環境変数 ===

			{{ic\|${XDG_CONFIG_HOME}/uwsm/env}} ファイルに設定されたすべての環境変数は、''uwsm'' によってソースされ、管理されているコンポジタおよびそのセッション内で実行されるグラフィカルアプリケーションで利用可能になります。
	All environment variables set in {{ic\|${XDG_CONFIG_HOME}/uwsm/env}} file are sourced by ''uwsm'' and available to all managed compositors and graphical applications run inside such a session.

			特定の''コンポジタ''(およびそのグラフィカルセッション内のグラフィカルアプリケーション)のみのために環境変数を設定する必要がある場合は、代わりに {{ic\|${XDG_CONFIG_HOME}/uwsm/env-''compositor''}} に入れてください。
	If you need certain environment variables to be set only for a specific ''compositor'' (and graphical applications in that graphical session), then put them in {{ic\|${XDG_CONFIG_HOME}/uwsm/env-''compositor''}} instead.

			これらのファイルでは、以下の形式で環境変数を設定する必要があります:
	All these files should set environment variables with the following format:

	{{bc\|export ''KEY1''{{=}}''VAR1''		{{bc\|1=export ''KEY1''=''VAR1''
	export ''KEY2''{{=}}''VAR2''		export ''KEY2''=''VAR2''
	export ''KEY3''{{=}}''VAR3''		export ''KEY3''=''VAR3''
	''...''}}		''...''}}

			コメントを含めるべきではありません。
	and should not contain comments.

	== ~~Usage~~ ==		== 使い方 ==

	=== ~~Startup~~ ===		=== 起動する ===

			''UWSM'' は、TTY と[[ディスプレイマネージャ]]によって開始できます。
	''uwsm'' can be started both by TTY and by a [[display manager]].

	==== TTY ====		==== TTY ====

	~~Add in your~~ {{ic\|~/.profile}} ~~file~~:		{{ic\|~/.profile}} ファイルに追加してください:

	{{bc\|if uwsm check may-start && uwsm select; then		{{bc\|if uwsm check may-start && uwsm select; then
53行目:		52行目:
	fi}}		fi}}

			同じ ''コンポジタ'' を常に起動したい場合は、代わりに {{ic\|~/.profile}} ファイルに次のように記述できます:
	If you want to always start the same ''compositor'', then you can use instead in your {{ic\|~/.profile}} file:

	{{bc\|if uwsm check may-start; then		{{bc\|if uwsm check may-start; then
59行目:		58行目:
	fi}}		fi}}

	==== ~~Display manager~~ ====		==== ディスプレイマネージャ ====

			''UWSM'' を介してコンポジタを開始するカスタムしたセッションデスクトップエントリを作成できます:
	You can create a custom session desktop entry which starts your compositor through ''uwsm'':

	{{hc\|/usr/share/wayland-sessions/my-compositor-uwsm.desktop\|[Desktop Entry]		{{hc\|/usr/share/wayland-sessions/my-compositor-uwsm.desktop\|[Desktop Entry]\|2=
	Name{{=}}My compositor (with UWSM)		Name=My compositor (with UWSM)
	Comment{{=}}My cool compositor, UWSM session		Comment=My cool compositor, UWSM session

	# either full command line with metadata and executable		# either full command line with metadata and executable
	Exec{{=}}uwsm start -N "My compositor" -D mycompositor:mylib -C "My cool compositor" -- my-compositor		Exec=uwsm start -N "My compositor" -D mycompositor:mylib -C "My cool compositor" -- my-compositor

	# or a reference to another entry		# or a reference to another entry
	Exec{{=}}uwsm start -- my-compositor.desktop		Exec=uwsm start -- my-compositor.desktop

	DesktopNames{{=}}mycompositor;mylib		DesktopNames=mycompositor;mylib
	Type{{=}}Application}}		Type=Application}}

	=== ~~Session termination~~ ===		=== セッション終了 ===

			現在の uwsm セッションを終了したい場合、次のいずれかを使用する必要があります:{{ic\|loginctl terminate-user ""}}(ユーザーセッション全体を終了)または {{ic\|uwsm stop}}({{ic\|uwsm start}} 後にコードを実行するか、[[ログインシェル]]を置き換えた場合はユーザーセッションを終了)
	If you want to terminate the current uwsm session, then you should use either {{ic\|loginctl terminate-user ""}} (terminates the entire user session) or {{ic\|uwsm stop}} (executes code after {{ic\|uwsm start}} or terminates user session, if it replaced the [[login shell]]).

			{{Warning\|コンポジタのネイティブな終了メカニズムを使用したり、そのプロセスを直接終了させたりしないでください。これにより、コンポジタがすべてのクライアントから突然切り離され、順序付けられたユニットの非アクティブ化シーケンスに干渉することになります。}}
	{{Warning\|Do not use a compositor's native exit mechanism or kill its process directly. This will yank the compositor from under all the clients and interfere with ordered unit deactivation sequence.}}

Kgx: 英語版から転載

2025-02-13T17:33:14Z

英語版から転載

新規ページ

[[Category:グラフィカルユーザーインターフェイス]]
[[en:Universal Wayland Session Manager]]
The [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] ('''uwsm''') wraps standalone [[Wayland#Compositors|Wayland compositors]] into a set of [[systemd]] units on the fly. This provides robust session management including environment, [[XDG Autostart]] support, bi-directional binding with login session, and clean shutdown.

{{Note|It is highly recommended to use [[Dbus-broker|dbus-broker]] as the D-Bus daemon implementation. Among other benefits, it reuses the systemd activation environment instead of having a separate one. This simplifies environment management and allows proper cleanup. The [[D-Bus#Reference_implementation|reference implementation]]
is also supported, but it does not allow unsetting vars, so a best effort cleanup is performed by setting them to an empty string instead. The only way to properly clean up the separate environment of the reference D-Bus daemon is to run {{ic|loginctl terminate-user ""}}.}}

== Installation ==

[[Install]] the {{Pkg|uwsm}} package.

== Configuration ==

=== Service startup notification and vars set by compositor ===

{{Note|If managed compositors already set {{ic|WAYLAND_DISPLAY}} (and other useful environment variables) into the systemd activation environment, then you can skip this section and you do not need to use {{ic|uwsm finalize}}.}}

In order to find the current compositor wayland applications need the {{ic|WAYLAND_DISPLAY}} (or {{ic|DISPLAY}} variable, if they are intended to run through [[Wayland#Xwayland|Xwayland]]). Therefore this and other useful environment variables should be put into the systemd/dbus activation environment once the compositor has set their value.

The command {{ic|uwsm finalize}} puts {{ic|WAYLAND_DISPLAY}}, {{ic|DISPLAY}} and other environment variables listed via the whitespace-separated {{ic|UWSM_FINALIZE_VARNAMES}} list into the activation environment. Therefore you need to execute this command after the compositor is ready.

If other variables set by the compositors are needed in your activation environment, then you can also pass them as arguments:

exec uwsm finalize ''VAR1'' ''VAR2'' ''...''

=== Environment variables ===

All environment variables set in {{ic|${XDG_CONFIG_HOME}/uwsm/env}} file are sourced by ''uwsm'' and available to all managed compositors and graphical applications run inside such a session.

If you need certain environment variables to be set only for a specific ''compositor'' (and graphical applications in that graphical session), then put them in {{ic|${XDG_CONFIG_HOME}/uwsm/env-''compositor''}} instead.

All these files should set environment variables with the following format:

{{bc|export ''KEY1''{{=}}''VAR1''
export ''KEY2''{{=}}''VAR2''
export ''KEY3''{{=}}''VAR3''
''...''}}

and should not contain comments.

== Usage ==

=== Startup ===

''uwsm'' can be started both by TTY and by a [[display manager]].

==== TTY ====

Add in your {{ic|~/.profile}} file:

{{bc|if uwsm check may-start && uwsm select; then
exec uwsm start default
fi}}

If you want to always start the same ''compositor'', then you can use instead in your {{ic|~/.profile}} file:

{{bc|if uwsm check may-start; then
exec uwsm start ''compositor''.desktop
fi}}

==== Display manager ====

You can create a custom session desktop entry which starts your compositor through ''uwsm'':

{{hc|/usr/share/wayland-sessions/my-compositor-uwsm.desktop|[Desktop Entry]
Name{{=}}My compositor (with UWSM)
Comment{{=}}My cool compositor, UWSM session

# either full command line with metadata and executable
Exec{{=}}uwsm start -N "My compositor" -D mycompositor:mylib -C "My cool compositor" -- my-compositor

# or a reference to another entry
Exec{{=}}uwsm start -- my-compositor.desktop

DesktopNames{{=}}mycompositor;mylib
Type{{=}}Application}}

=== Session termination ===

If you want to terminate the current uwsm session, then you should use either {{ic|loginctl terminate-user ""}} (terminates the entire user session) or {{ic|uwsm stop}} (executes code after {{ic|uwsm start}} or terminates user session, if it replaced the [[login shell]]).

{{Warning|Do not use a compositor's native exit mechanism or kill its process directly. This will yank the compositor from under all the clients and interfere with ordered unit deactivation sequence.}}