از طریق خط فرمان

راه‌اندازی یک برنامه:

gapplication launch org.example.fooview

باز کردن یک فایل با یک برنامه:

gapplication launch org.example.fooview ~/file.foo

باز کردن چند فایل با یک برنامه:

gapplication launch org.example.fooview ~/foos/*.foo

فراخوانی یک کنش روی یک برنامه:

gapplication action org.example.fooview create

فراخوانی یک کنش روی یک برنامه، به همراه پارامتر:

gapplication action org.example.fooview show-item '"item_id_828739"'

از طریق خطوط Exec در فایل‌های .desktop

رابط خط فرمانی gapplication به گونه‌ای طراحی شده است که بتوان آن را مستقیماً از خط Exec یک فایل .desktop استفاده کرد.

ممکن است بخواهید این کار را برای برقراری سازگاری عقبرو با پیاده‌سازی‌هایی از مشخصات که روش فعال‌سازی با D-Bus را نمی‌دانند انجام دهید، بدون این که نیاز به نصب یک برنامه کمکی مجزا باشد.

مثال زیر را در نظر بگیرید:

[Desktop Entry]
Version=1.1
Type=Application
Name=Foo Viewer
DBusActivatable=true
MimeType=image/x-foo;
Exec=gapplication launch org.example.fooview %F
Actions=gallery;create;
[Desktop Action gallery]
Name=Browse Gallery
Exec=gapplication action org.example.fooview gallery
[Desktop Action create]
Name=Create a new Foo!
Exec=gapplication action org.example.fooview create

از طریق یک اسکریپت

هنگام نصب برنامه‌ای که از فعال‌سازی با D-Bus پشتیبانی می‌کند، ممکن است همچنان بخواهید فایلی را در /usr/bin قرار دهید تا برنامه‌تان از درون یک پایانه قابل اجرا باشد.

امکان دارد که این فایل یک اسکریپت شل باشد. این اسکریپت می‌تواند آرگومان‌هایی مانند --help و --version را مستقیماً مدیریت کند. همچنین می‌تواند دیگر آرگومان‌های خط فرمان را پردازش کرده و آن‌ها را به استفاده از gapplication برای فعال‌سازی برنامه، باز کردن فایل‌ها، یا فراخوانی کنش‌ها تبدیل نماید.

در اینجا یک مثال ساده‌شده آورده شده است، مانند آنچه ممکن است در /usr/bin/fooview نصب شود:

#!/bin/sh
case "$1" in
  --help)
    echo "see ‘man fooview’ for more information"
    ;;
  --version)
    echo "fooview 1.2"
    ;;
  --gallery)
    gapplication action org.example.fooview gallery
    ;;
  --create)
    gapplication action org.example.fooview create
    ;;
  -*)
    echo "unrecognized commandline argument"
    exit 1
    ;;
  *)
    gapplication launch org.example.fooview "$@"
    ;;
esac