Solaris 一般桌上管理系統環境：進階使用者和系統管理員指南

第 5章註冊應用程式

本章描述如何建立應用程式的註冊套裝軟體，以及如何註冊桌上管理系統上的應用程式。

當應用程式完整註冊於桌上管理系統上時，它有：

它自己在應用程式管理者頂層的應用程式群組

啟動應用程式的動作。動作是由應用程式群組中的圖像所代表

其資料檔案的選擇性資料類型

應用程式註冊對應用程式而言是非侵入性的作業：

它本身不包含可執行的應用程式的修改。因此，您可以在系統上註冊現存應用程式。

它不需要將任何應用程式的發送檔案（例如可執行的與 app-defaults）移動到其它的檔案位置。

它可以很輕易地還原。用於註冊應用程式的 dtappintegrate 工具提供反向處理的指令行選項。

您將會想要建立註冊套裝軟體的，如果您是：

想要在桌上管理系統註冊現存應用程式的系統管理者

想要為智慧型桌上管理系統應用程式建立安裝套裝軟體的軟體程式設計者

應用程式註冊的概觀

本節解釋：

應用程式註冊的目的
由應用程式註冊所提供給您的應用程式功能

註解 -

有關顯示如何註冊現存應用程式的詳細範例，請參閱 "建立註冊套裝軟體的範例"。

由應用程式註冊所提供的功能

應用程式註冊提供圖形的方法給使用者以：

尋找您的應用程式。

安裝時，您的應用程式 "註冊" 至應用程式管理者，並有其自己的應用程式群組。

圖 5-1 在應用程式管理者頂層的應用程式群組

啟動您的應用程式。

您的應用程式的應用程式群組包含一個使用者可以連按兩下以啟動您的應用程式的圖像。

圖 5-2 包含可啟動應用程式的圖像之應用程式群組

識別與處理資料檔案。應用程式的資料檔案在檔案管理者中將會有一個唯一的圖像。

使用者可以使用資料檔案圖像以：
- 啟動（開啟）應用程式
- 列印資料檔案

圖 5-3 資料檔案的即現式功能表包含 ``開啟'' 與 ``列印''

執行其它的作業，例如郵寄、壓縮、查看或播放（聲訊）資料

應用程式註冊的目的

已註冊的桌上管理系統應用程式有由桌上管理系統所使用的特定的配置檔案，以提供應用程式的使用者介面：

動作與資料類型定義檔案
圖像影像（圖素映射或位元映射）檔案
建立應用程式群組的目錄與檔案
選擇性的桌上管理系統輔助說明檔案與前方面板定義檔案

為了認出這些檔案並由桌上管理系統所使用，它們必須在由桌上管理系統搜尋路徑所指定的特定目錄中。

當其配置檔案分散在眾多的目錄之中時，要管理應用程式是很困難的。因此，桌上管理系統允許應用程式在單一目錄之下收集其所有的桌上管理系統配置檔案。此檔案群組稱為 註冊套裝軟體。

如果應用程式是智慧型桌上管理系統，其會供應註冊套裝軟體作為其安裝套裝軟體的一部分。如果您是自己建立配置檔案的系統管理者，您便可以自己建立註冊套裝軟體。

註冊套裝軟體中的配置檔案不供桌上管理系統使用，因為它們並非位於正確的搜尋路徑目錄中。將這些檔案放在正確位置中的處理稱為 註冊 或 整合 應用程式。

桌上管理系統提供一種工具 dtappintegrate，其藉由建立正確的搜尋路徑目錄中檔案的象徵性連結表示方式來執行註冊。

許多智慧型桌上管理系統應用程式將會在安裝處理期間自動執行 dtappintegrate。如果您是整合現存應用程式的系統管理者，您可以在建立註冊套裝軟體之後自己執行它。

只要應用程式一在系統的桌上管理系統上註冊，應用程式就可供系統上所有的使用者使用。如果系統配置為桌上管理系統應用程式伺服器，應用程式也可供整個網路上的其它系統使用。

dtappintegrate 工具有藉由中斷連結以反向處理的指令行選項。這使得要從應用程式管理者刪除應用程式變得更加容易，因此它可以移動至不同的應用程式伺服器或更新。

註冊應用程式的一般步驟

註解 -

有關使用這些步驟以建立應用程式套裝軟體的詳細範例，請參閱 "建立註冊套裝軟體的範例"。

修改任何設定字型與色彩的應用程式來源。否則，桌上管理系統的動態字型與色彩將不會正確地運作。

請參閱 "第 1 步：修改字型與色彩來源"。

建立應用程式 root 位置。

請參閱 "第 2 步：建立桌上管理系統應用程式 Root"。

建立在應用程式 root 之下的目錄結構。

請參閱 "第 3 步：建立註冊套裝軟體目錄"

建立應用程式的動作與資料類型。

請參閱 "第 4 步：建立應用程式的動作與資料類型"。

將輔助說明檔案放在合適的目錄中。

請參閱 "第 5 步：將輔助說明檔案放在註冊套裝軟體中"。

建立應用程式的圖像

請參閱 "第 6 步：建立應用程式的圖像"。

建立應用程式的應用程式群組。

請參閱 "第 7 步：建立應用程式群組"。

使用 dtappintegrate 來註冊應用程式。

請參閱 "第 8 步：使用 dtappintegrate 註冊應用程式"。

第 1 步：修改字型與色彩來源

註解 -

有關修改應用程式來源的範例，請參閱 "建立註冊套裝軟體的範例" 的第 1 步。

桌上管理系統提供設定與處理介面字型和視窗色彩的機制。為了使應用程式正確地使用這些機制，您可能需要修改應用程式的 app-defaults 檔案。

修改字型來源

註解 -

本節應用於使用 OSF/Motif 1.2 (TM)（或較新的版本）建立的應用程式。樣式管理者無法設定使用較早版本的 OSF/Motif 寫入的應用程式介面字型。

如果應用程式沒有指定特定的應用程式字型，桌上管理系統樣式管理者將會設定使用 OSF/Motif 1.2（或較新的版本）建立的應用程式介面字型。

樣式管理者提供兩種字型：

系統字型-由例如是標籤、功能表與按鈕之類的系統區域使用

使用者字型-用於例如是文字欄位之類的可編輯區域

每種字型都提供有七種大小，在字型對話框中從 1 標到 7。樣式管理者字型經由/usr/dt/app-defaults/language/Dtstyle 中所設定的樣式管理者來源連接至系統上的實際字型。

如果您希望應用程式使用樣式管理者字型，您應該刪除任何介面指定字型的應用程式來源。桌上管理系統將會自動適當地設定應用程式的來源：

FontList-設定至系統字型

XmText*FontList-設定至使用者字型

XmTextField*FontList-設定至使用者字型

修改色彩來源

樣式管理者提供動態變更應用程式色彩的能力。應用程式必須是 OSF/Motif 1.1 或 1.2 客戶機。以其它工具箱所寫入的客戶機無法動態變更色彩；客戶機重新啟動時，色彩變更會生效。

使用由桌上管理系統所提供的動態色彩的最簡單方法就是刪除任何應用程式背景與前景色彩的色彩來源。

第 2 步：建立桌上管理系統應用程式 Root

註解 -

有關建立應用程式的桌上管理系統應用程式 root 目錄的範例，請參閱 "建立註冊套裝軟體的範例" 的第 2 步。

應用程式的註冊套裝軟體檔案是聚集於稱為應用程式 root 或 app_root 的目錄之下。用於桌上管理系統配置檔案的 app_root 目錄可以與應用程式的安裝 app_root 或某其它位置是相同的目錄。

例如，假設應用程式安裝於目錄 /usr/BTE 之下。此相同的目錄可用作桌上管理系統配置檔案的 app_root。然而，如果您正在整合現存非桌上管理系統智慧型應用程式，請建立不同的桌上管理系統 app_root 目錄。此將會防止您所建立的配置檔案在您更新應用程式時被重寫。

例如，系統管理者可能會想要建立目錄 /etc/desktop_approots/BTE 為桌上管理系統 app_root 目錄。

第 3 步：建立註冊套裝軟體目錄

註解 -

有關建立應用程式的註冊套裝軟體目錄的範例，請參閱 "建立註冊套裝軟體的範例" 的第 3 步。

註冊套裝軟體是由桌上管理系統使用來提供應用程式的圖形介面的桌上管理系統配置檔案的群組。

註冊套裝軟體內容

桌上管理系統配置檔案包括：

動作與資料類型定義檔案
圖像影像檔案
應用程式群組目錄與其內容
選擇性的：輔助說明資料檔案與前方面板配置檔案

註冊套裝軟體是在稱為應用程式 root 或 app_root 的頂層目錄之下所收集的。

圖 5-4 在應用程式根目錄之下的註冊套裝軟體

在 app_root/dt/appconfig 目錄之下的配置欄位之主要種類如表 5-1 所示。

表 5-1 配置欄位主要種類


子目錄	內容
`類型`	動作與資料類型定義檔案
`輔助說明`	桌上管理系統輔助說明檔案
`圖像`	由應用程式的動作與資料類型所使用的位元映射與圖素映射影像檔案
`appmanager`	建立應用程式群組的目錄與內容

每一種主要種類中都有語言相依的檔案子目錄。內定語言檔案放在 C 目錄中。

如果要建立註冊套裝軟體

建立這些目錄。如果您正提供語言相依的配置檔案，請為每種語言建立分開的目錄。如果您只供應一種語言，請將檔案放在 C 目錄中。

app_root/dt/appconfig/types/language

app_root/dt/appconfig/help/language

app_root/dt/appconfig/icons/language

app_root/dt/appconfig/appmanager/language/appgroup_name，其中 appgroup_name 是應用程式群組的名稱。

例如，圖 5-5 顯示包含其 appgroup_name 為 "Media_Tools." 的群組的應用程式管理者

圖 5-5 應用程式管理者頂層的應用程式群組

dtappintegrate 工具只在 類型、輔助說明、圖像 與 appmanager 目錄中的桌上管理系統配置檔案上作業。應用程式的可執行二進位、app-defaults 與訊息目錄檔案是分開管理的。

第 4 步：建立應用程式的動作與資料類型

註解 -

有關建立應用程式的動作與資料類型的範例，請參閱 "建立註冊套裝軟體的範例" 的第 4 步。

動作與資料類型提供應用程式的使用者介面。

動作提供使用者介面給指令以啟動應用程式。
資料類型提供應用程式資料檔案的自訂外觀與行為。

應用程式所需的動作與資料類型

典型的應用程式會需要下列的動作與資料類型定義：

開啟應用程式的動作。
您的應用程式的資料檔案的資料類型。如果您建立一種資料類型，您也將會想要建立：
- 您的應用程式的資料檔案開啟動作
- 您的應用程式的資料檔案列印動作
應用程式群組的資料類型（請參閱 "配置應用程式群組以使用唯一的圖像"）。

有關如何在桌上管理系統中使用動作與資料類型的指令，請參閱第 10章, 動作與資料類型簡介。

動作與資料類型定義配置檔案的位置

動作與資料類型定義於配置檔案中。包含動作與資料類型定義的檔案的唯一命名需求就是它們必須是 .dt 字尾。按習慣用法，您可能會想要命名檔案為 action_name.dt 或 application_name.dt。

將包含動作與資料類型的檔案放在目錄 app_root/dt/appconfig/types/language 中的應用程式 root 之下。內定 語言 為 C。

圖 5-6 動作與資料類型定義檔案

建立動作與資料類型的方法

您可以用下列兩種方法任一來建立應用程式的動作與資料類型定義：

使用建立動作工具。

建立動作會用您填入的文字欄位提供簡單易用的介面。然而，此工具有特定的限制。

人工建立定義。

此需要您學習建立定義的語法，但提供完整功能範圍的存取。

如果要使用建立動作來建立動作與資料類型

此程序使用建立動作公用程式以建立應用程式的動作與資料類型。

有關建立動作的更多資訊，請使用其線上輔助說明或參閱第 11章, 使用建立動作來建立動作與資料類型。

開啟 Desktop_Apps 應用程式群組並連按兩下建立動作。

使用建立動作來建立應用程式與其資料類型的動作與資料類型定義。

由建立動作所建立的配置檔案將會寫入至 HomeDirectory/.dt/type/action_name.dt。 動作檔案（具有與動作相同名稱的可執行檔案）是放在您的主目錄中。

使用您的主目錄中所建立的動作檔案來測試動作。

將動作定義檔案 HomeDirectory/.dt/type/action_name.dt 複製到 app_root/dt/appconfig/types/language directory。

在建立應用程式群組目錄之後（請參閱 "第 7 步：建立應用程式群組"），將動作檔案 HomeDirectory/action_name 複製到 app_root/dt/appconfig/appmanager/language/appgroup_name 目錄。

如果要人工建立動作與資料類型

建立包含應用程式的動作與資料類型定義的配置檔案。

動作與資料類型定義檔案必須遵循命名習慣用法 name.dt。

您可以將您所有的動作與資料類型定義放在一個檔案中，或是將它們分散在多重檔案之中。對於每個檔案，請使用系統管理者將會輕易地與您的應用程式連接的檔案名稱。

動作與資料類型名稱必須是一個字（無內含的空間）。您可以使用底線字元。按習慣用法，動作或資料類型名稱的第一個字母是大寫的。請勿使用現存動作名稱或檔案名稱。使用進階使用者與系統管理將會輕易地與您的應用程式連接的名稱。

如果您想要讓應用程式的圖像標上與動作名稱有效不同的名稱，請將 標籤 欄位包含在動作定義中。

有關建立動作與資料類型的更多資訊，請參閱：

第 5 步：將輔助說明檔案放在註冊套裝軟體中

註解 -

有關增加輔助說明檔案至註冊套裝軟體的範例，請參閱 "建立註冊套裝軟體的範例" 的第 5 步。

如果應用程式包括桌上管理系統輔助說明內容（以桌上管理系統輔助說明設計者工具箱建立的輔助說明內容），輔助說明內容主控者檔案（*.sdl）應放在目錄 app_root/appconfig/help/language 中。

由輔助說明檔案所使用的圖形通常是放在 圖形 子目錄中。圖形必須是位於在建立輔助說明內容時與主控者輔助說明內容（*.sdl）檔案相對的相同目錄中。

如果應用程式不提供輔助說明內容，若是您有輔助說明設計者工具箱，您就可以建立一個。

有兩個輔助說明內容整合的層次：

全部整合。

當桌上管理系統輔助說明全部整合時，輔助說明內容可以由應用程式存取-例如，由關於項目輔助說明與輔助說明功能表。全部整合包含可執行應用程式的修改。

部分整合。

當桌上管理系統部分整合時，它可以從輔助說明管理員的頂層提供使用。然而，您無法從應用程式的視窗存取輔助說明內容。您也可以提供動作以從應用程式群組存取輔助說明。以下範例動作顯示位於輔助說明主控者檔案 MyApp.sdl 中的輔助說明內容：

	ACTION OpenMyAppHelp   
                {
                LABEL           MyAppHelp  
		ARG_COUNT       0  	      
                TYPE            COMMAND  	     
                WINDOW_TYPE     NO_STDIO  
		EXEC_STRING     /usr/dt/bin/dthelpview -helpVolume MyApp 
                DESCRIPTION            顯示 MyApp 應用程式的輔助說明。
                }

第 6 步：建立應用程式的圖像

註解 -

有關建立應用程式的圖像檔案範例，請參閱 "建立註冊套裝軟體的範例" 的第 6 步。

桌上管理系統提供動作、資料類型與應用程式群組的內定圖像。然而，您或許將會想要建立應用程式的唯一圖像。

將圖像放在目錄 app_root/dt/appconfig/icons/language 中。

桌上管理系統所需的圖像

應用程式在桌上管理系統上使用這些圖像影像：

動作圖像。 這是使用者連按兩下以啟動您的應用程式（動作）的圖像。參考其於啟動應用程式的動作 圖像 欄位中。

供應三種大小：小型、中型與大型。

資料類型圖像。 此圖像是用於代表檔案管理者中應用程式的資料檔案。參考其於資料類型定義的 圖像 欄位中。

如果您的應用程式支援多重資料類型，您應該提供不同的圖像給每種資料類型。

供應兩種大小：小型與中型。

應用程式群組圖像。 這是代表在應用程式管理者頂層的目錄圖像。參考其於應用程式群組的資料類型定義 圖像 欄位中。（請參閱 "第 7 步：建立應用程式群組"。）

供應兩種大小：小型與中型。

您可能需要供應每個圖像的圖素映射與位元映射兩種版本以支援彩色（八位元的與更大的）以及單色（少於八位元）顯示器。

表 5-2 圖像檔案的命名習慣用法


大小	像素空間	位元映射名稱	圖素映射名稱
小型	16 乘 16	`基本名稱.t.bm`	`基本名稱.t.pm`
中型	32 乘 32	`基本名稱.m.bm`	`基本名稱.m.pm`
大型	48 乘 48	`基本名稱.l.bm`	`基本名稱.l.pm`

如果您不提供位元映射檔案，桌上管理系統會對應圖素檔案的色彩規格至黑色與白色。然而，此對應可能無法製造您所想要的外觀。

有關圖像的更多資訊，請參閱 "圖像影像檔案"。

第 7 步：建立應用程式群組

註解 -

有關建立應用程式群組的範例，請參閱 "建立註冊套裝軟體的範例" 的第 7 步。

只要您一建立應用程式的動作與資料類型定義，您就必須建立負責建立使用者實際上看到-應用程式群組與其內容的配置檔案。

應用程式群組是在應用程式管理者頂層的目錄（請參閱圖 5-1）。

建立應用程式群組有三個步驟：

選擇性的：配置應用程式群組以使用唯一的圖像。此包含建立應用程式群組目錄的資料類型定義。

建立應用程式群組的內容。

建立應用程式群組目錄

如果要建立應用程式群組，請在 appmanager 之下的註冊套裝軟體中建立目錄，如圖 5-7 中所示。

圖 5-7 `appmanager` 目錄

應用程式群組名稱

圖 5-7 中的 <appgroup_name> 是應用程式群組的名稱。

圖 5-8 應用程式群組名稱（<appgroup_name>）

此名稱可以是任何可允許的檔案（目錄）名稱。使用描述應用程式的名稱。

配置應用程式群組以使用唯一的圖像

桌上管理系統提供內定應用程式群組的圖像。然而，您可能會想要提供自訂圖像。

如果您想要提供唯一的圖像給應用程式群組，您必須建立：

在應用程式管理者頂層出現的目錄的資料類型。

開啟並列印資料類型的動作。

例如，假設您想要建立稱為 Media_Tools 的應用程式群組。以下放在檔案 app_root/dt/appconfig/types/language/name.dt 中的資料類型定義指派一個唯一的圖像給應用程式群組圖像。
```
DATA_ATTRIBUTES  Media_ToolsAppgroup  
{     
      ACTION       OpenInPlace,OpenNewView     
			 ICON          MediaTools     
      DESCRIPTION   連按兩下以開啟 Media_Tools \  應用程式群組  
}
```
```
DATA_CRITERIA		Media_ToolsAppgroupCriteria1  
{     
      DATA_ATTRIBUTES_NAME Media_ToolsAppgroup     
      MODE   d     
      PATH_PATTERN         */appmanager/*/Media_Tools  
} 
```
定義的屬性區段指定使用的圖像。定義的條件區段指定將資料類型定義為任何名為 Media_Tools 的目錄，而且此目錄是名為 appmanager 的目錄之子目錄。

圖 5-9 顯示應用程式群組名稱與資料類型定義之間的關係。資料類型定義中的 PATH_PATTERN 欄位將唯一的圖像連接至應用程式群組。

圖 5-9 應用程式群組如何取得唯一的圖像

您也應該建立應用程式群組資料類型的開啟與列印動作：

ACTION Open  
 { 
		ARG_TYPE    		Media_ToolsAppGroup
		TYPE			MAP  
		MAP_ACTION		OpenAppGroup 
 }

ACTION print 
  {      
		ARG_TYPE       		Media_ToolsAppGroup   
		TYPE	  		MAP  
		MAP_ACTION		PrintAppGroup 
  }

OpenAppGroup 與 PrintAppGroup 動作是 /usr/dt/appconfig/types/language/dtappman.dt 中所定義的內建動作。

建立應用程式群組的內容

應用程式群組中最重要的項目就是啟動應用程式（動作圖像）的圖像。如果應用程式群組包含一組應用程式，通常每組應用程式都會有一個圖像。

除了一個或多個動作圖像以外，應用程式群組還可包含：

一個或多個讀我檔案
一個或多個範例資料檔案
樣板
使用者可以連按兩下以查看輔助說明資訊的圖像
線上援助頁
專用的前方面板控制

應用程式群組可以包含子目錄。

建立動作檔案（應用程式圖像）

應用程式群組應包含啟動應用程式的圖像。如果群組供應一組應用程式，每個應用程式應該都有一個圖像。既然它們代表隱藏的動作，這些圖像就稱為 應用程式圖像 或 動作圖像。

動作圖像是藉由建立具有與其將會執行的動作相同名稱的可執行檔案所建立的：

app_root/dt/appconfig/appmanager/appgroup_name/action_name

此檔案稱為 動作檔案，因為它的目的是建立隱藏動作的視覺表示方式。

例如，如果您已建立執行 BestTextEditor 應用程式的名為 BestTextEditor 的動作，您就會執行名為 BestTextEditor 的可執行的檔案。在檔案管理者與應用程式管理者中，動作檔案將會使用動作定義中所指定的圖像影像。

圖 5-10 舉例說明動作定義、動作檔案與應用程式管理者視窗實際登錄之間的關係。

圖 5-10 應用程式圖像是應用程式群組中的一個檔案

讀我檔案

桌上管理系統提供讀我資料類型，您可以將其用於您的應用程式的讀我檔案。使用這些命名習慣用法之一：

讀我
讀我
README.*
Read.*.Me
read.*.me
READ.*.ME

建立專用的前方面板控制

在大部分的情況中，您不需要提供前方面板的控制定義；使用者可以藉由將動作圖像定位於子面板中的安裝圖像控制來將應用程式增加至前方面板。

如果您想要使用者能夠安裝行為不同於動作圖像的控制，您可能需要為您的應用程式建立一個包含控制定義的前方面板配置檔案-例如，假設控制在被監視的檔案變更的同時監視一個檔案並變更外型。

前方面板配置檔案是放在 app_root/dt/appconfig/types/language 目錄中。命名習慣用法為 name.fp。

如果您供應包含控制的配置檔案，使用者就可以藉由將 *.fp 檔案定位於子面板中的安裝圖像控制來將控制增加至子面板。

例如，以下定義可以放在應用程式群組中的前方面板配置檔案中。如果使用者將此檔案定位於子面板中的安裝圖像控制上，即在執行 BestTextEditor 應用程式的單一實例的子面板中建立控制。如果 BestTextEditor 已經在執行，視窗會移動至目前工作區中的視窗堆疊頂端。

CONTROL BestTextEditorControl 
	{      
		TYPE      icon
		ICON      BTEFPanel	  
		PUSH_RECALL    	True   
   CLIENT_NAME  	BTEd  
   PUSH_ACTION  	BTEditor  
		DROP_ACTION    	BTEditor   
   HELP_STRING   	start BestTextEditor application。  
 }

有關建立前方面板配置檔案的其它資訊，請參閱：

第 15章, 進階前方面板自訂
dtfpfile(4) 線上援助頁

第 8 步：使用 dtappintegrate 註冊應用程式

註解 -

有關註冊應用程式的範例，請參閱 "建立註冊套裝軟體的範例" 的第 8 步。

只要您已在應用程式 root 之下建立註冊套裝軟體，您就已準備好可執行實際的應用程式註冊。

應用程式註冊建立註冊套裝軟體與位於沿著桌上管理系統搜尋路徑的目錄之間的連結（請參閱 "dtappintegrate 如何整合應用程式 "）。

如果要註冊具有 dtappintegrate 的應用程式

如果應用程式是智慧型桌上管理系統，dtappintegrate通常會自動以起始處理中的最後步驟來執行。如果它不是自動執行，或是如果您已建立配置檔案以整合非桌上管理系統智慧型應用程式，那麼您就可以人工執行 dtappintegrate。

登入為 root。

執行指令：
```
	/usr/dt/bin/dtappintegrate -s  app_root
```
其中 app_root 為桌上管理系統應用程式的根目錄。有關更多的資訊，請參閱dtappintegrate(1) 線上援助頁。

開啟 Desktop_Tools 應用程式群組並連按兩下重新載入應用程式。

驗證已正確地註冊應用程式：
1. 顯示應用程式管理者的頂層。新的應用程式群組應出現在應用程式管理者中。
2. 開啟應用程式群組並連按兩下動作圖像。

`dtappintegrate` 的語法與選項

dtappintegrate -s app_root 
[-t target_path ] [-l language 
] [-u]

`-s` `app_root`	所需的參數，指定應用程式在其下安裝的應用程式 root。
`-t` `target_path`	選擇性的參數，內定成系統位置 `/etc/dt/appconfig`。指定桌上管理系統配置檔案連接的位置。您必須使用在應用程式搜尋路徑上的位置。
`-l` `語言`	選擇性的參數，內定成所有語言。指定語言相依的桌上管理系統配置檔案來整合。
`-u`	選擇性的參數，取消整合應用程式，刪除所有在整合期間所設定的連結。

`dtappintegrate` 如何整合應用程式

dtappintegrate 的功能是在安裝的檔案與桌上管理系統尋找配置檔案的位置之間設定連結。

動作與資料類型

dtappintegrate 從註冊套裝軟體中的動作與資料類型定義檔案起，建立象徵性連結至沿著動作資料庫輔助說明搜尋路徑的整個系統的目錄。其完成是藉由建立連結自

app_root/dt/appconfig/types/language/*.dt

至

/etc/dt/appconfig/types/language/*.dt

輔助說明資訊檔案

dtappintegrate 從註冊套裝軟體中的輔助說明檔案起，建立象徵性連結至沿著輔助說明搜尋路徑的整個系統的目錄。其完成是藉由建立連結自

app_root/dt/appconfig/help/language/help_file.sdl

至

/etc/dt/appconfig/help/language/help_file.sdl

圖像檔案

dtappintegrate 從註冊套裝軟體中的圖像檔案起，建立象徵性連結至沿著圖像搜尋路徑的整個系統的目錄。其完成是藉由建立連結自

app_root/dt/appconfig/icons/language/icon_files

至

/etc/dt/appconfig/icons/language/icon_files

應用程式群組

如果要將應用程式的應用程式群組放在應用程式管理者的頂層中，dtappintegrate 會建立在註冊套裝軟體中的應用程式群組與沿著應用程式搜尋路徑的整個系統的位置之間的連結。其完成是藉由建立連結自目錄

app_root/dt/appconfig/appmanager/language/appgroup_name

至

/etc/dt/appconfig/appmanager/language/appgroup_name

建立註冊套裝軟體的範例

下列步驟建立現存名為 BestTextEditor 的非桌上管理系統的智慧型應用程式註冊套裝軟體。

您需要知道的有關 ``BestTextEditor'' 的資訊

範例假定下列有關 BestTextEditor 應用程式的事實：

使用者的階段作業語言為內定值，C。

啟動 BestTextEditor 的指令行是：
```
	BTEd {檔案名稱]
```
其中 檔案名稱 是新視窗中欲做開啟的資料檔案名稱。BestTextEditor 建立其自己的視窗-也就是說，它不在終端機模擬器視窗內執行。

BestTextEditor 建立並使用兩種類型的資料檔案：
- 文件檔案。其使用命名習慣用法 *.bte。BestTextEditor 提供列印其 .bte 資料檔案的指令行。此指令的語法為：
```
		BTEPrint [-d 目標] [-s] 檔案名稱
```
  其中：
  
  -d 目標-指定目標印表機。
  
  -s-指定靜音列印。不顯示應用程式的列印對話框。
  
  檔案名稱-指定要列印的檔案。
- 樣板檔案。其使用命名習慣用法 *.tpl。無法列印樣板檔案。

BestTextEditor 的現存非桌上管理系統 app-defaults 檔案包含介面字型以及前景與背景色彩的來源。

BestTextEditor 的線上輔助說明內容是使用桌上管理系統輔助說明設計者工具箱來建立的。當建立線上輔助說明內容時，其使用下列的來源檔案：
```
.../BTEHelp.htg  	
 .../graphics/BTE1.xwd  
	.../graphics/BTE2.xwd
```
並產生檔案 .../BTEHelp.sdl。

註冊 ``BestTextEditor'' 的步驟

以下逐步的程序註冊了 BestTextEditor。

修改字型與色彩來源。

在 BestTextEditor 的 app-defaults 檔案中，刪除設定如下的來源：
- 文字的字型
- 前景與背景的色彩

建立應用程式 root。

建立目錄：
```
/Desktop_approots/BTE
```
如果您正在整合現存應用程式，您應該在應用程式的安裝位置以外之處建立應用程式根目錄；否則，當您更新應用程式時，您所建立的配置檔案可能會被刪除。

建立註冊套裝軟體目錄。

建立這些目錄：

/desktop_approots/BTE/dt/appconfig/types/C   
   /desktop_approots/BTE/dt/appconfig/help/C  
   /desktop_approots/BTE/dt/appconfig/icons/C 
   /desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor

建立應用程式的動作與資料類型。

建立動作與資料類型定義的配置檔案：
```
/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt
```

建立執行 BestTextEditor 的動作定義：

ACTION BTEditor  		
{  				
	WINDOW_TYPE				NO_STDIO  				
	ICON						BTERun  
	DESCRIPTION				連按兩下此圖像或定位 \ 
	                  a BTE 資料檔案於其上以執行 \ BestTextEditor.  
	EXEC_STRING				/usr/BTE/BTEd%Arg_1%
}

建立 *.bte 檔案的資料類型：

DATA_ATTRIBUTES 	BTEDataFile  
    {   
      DESCRIPTION   		BestTextEditor data file。  			       
      ICON    		BTEData       
      ACTION 		Open, Print  	  
    }
    
    DATA_CRITERIA BTEDataFileCriteria1        
    {  
      DATA_ATTRIBUTES_NAME	BTEDataFile 
      NAME_PATTERN  	 *.bte  
      MODE          f  
    }

建立 *.tpl 檔案的資料類型：

 DATA_ATTRIBUTES BTETemplateFile 
 {                                                                                                                                                                                                                                                                                                                                                                                 					          DESCRIPTION			BestTextEditor    樣板檔案。  	 
   ICON	      BTETempl 
   ACTION	        Open
  } 
       
   DATA_CRITERIAL BTETemplateFileCriteria1 
  { 
    DATA_ATTRIBUTES_NAME	        BTETemplateFile  
	 NAME_PATTERN	  	*.tpl 
    MODE		  f     
   }

建立 *.bte 檔案的開啟動作。

ACTION Open  	
{
  ARG_TYPE  	BTEDataFile  	
  TYPE	    MAP  
  MAP_ACTION     BTEditor
}

建立 *.bte 檔案的列印動作。

此為將會列印資料檔案的簡單列印動作。這些動作需要 LPDEST 環境變數的值並略過 -s 列印選項。（如果 LPDEST未設定，動作可能會失敗。）

ACTION Print  		
{  				
	ARG_TYPE				BTEDataFile  				
	TYPE 					MAP  
	MAP_ACTION			BTEPrintData  		
}

ACTION BTEPrintData  		
{ 		
	WINDOW_TYPE				NO_STDIO  
	EXEC_STRING				BTEPrint -d $LPDEST%Arg _1%
}

此為 BTEPrintData 動作與伴隨的指令集之另一種版本。它們共同處理未設定的 LPDEST 或是如果要求靜音列印的情況。

ACTION BTEPrintData  		
{
	WINDOW_TYPE				NO_STDIO
	EXEC_STRING				/usr/BTE/bin/BTEenvprint \  
	   %（File）Arg_1%
}

/usr/BTE/bin/BTEenvprint 指令集的內容為：

# BTEenvprint  
#!/bin/sh  
DEST=""  
SILENT= "" 
if [ $LPDEST ] ; then  		       
DEST="-d $LPDEST "  	 
fi 
BTEPrint $DEST SILENT $1

建立 *.tpl 檔案的開啟動作：

ACTION Open
{ 
	ARG_TYPE     BTETemplateFile
	TYPE         MAP  
	MAP_ACTION   BTEditor 
}

建立 *.tpl 檔案的列印動作：
```
ACTION Print  
{ 
	ARG_TYPES	   BTETemplateFile 
	TYPE         MAP  
	MAP_ACTION   NoPrint  
}
```
無列印是內建的動作，會顯示對話框告訴使用者無法列印的檔案。

將輔助說明檔案放在註冊套裝軟體中。

將輔助說明檔案放在下列位置中：

/desktop_approots/BTE/dt/appconfig/help/C/BTEHelp.sdl  
   /desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE1.xwd
  	/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE2.xwd

建立檔案：

		/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt.

將以下動作定義放在檔案中：

ACTION BTEHelp  		
{  				
	WINDOW_TYPE		NO_STDIO  				
	EXEC_STRING		/usr/dt/bin/dthelpview -helpVolume \ BTEHelp.sdl  				
	DESCRIPTION		開啟 	BestTextEditor 	輔助說明內容。  		
}

建立應用程式的圖像。

使用圖像編輯器來建立圖像。表 5-3 顯示使用的大小指導。
表 5-3 圖像大小指導

名稱

大小

基本名稱.t.pm

16 乘 16

基本名稱.m.pm

32 乘 32

基本名稱.l.pm

48 乘 48

在目錄 /desktop_approots/BTE/dt/appconfig/icons/C 中建立這些圖像檔案：
- 代表執行應用程式的動作的圖像：BTERun.t.pm、BTERun.m.pm、BTERun.l.pm
- 代表 *.bte 檔案的圖像：BTEData.t.pm、BTEData.m.pm、
- 代表 *.tpl 檔案的圖像：BTETempl.t.pm、BTETempl.m.pm
- 代表應用程式群組（用於步驟 7 中）的圖像：BTEApp.t.pm、BTEApp.m.pm

建立應用程式群組。
1. 如果您尚未如此作，請建立此目錄。
```
	/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor
```
2. 此步驟是選擇性的。其藉由建立資料類型以及相關的應用程式群組動作來提供應用程式群組圖像的唯一圖像。如果您省略此步驟，應用程式群組將會使用內定圖像。
  
  將下列資料類型與動作定義增加至檔案 /desktop_approots/BTE/dt/appconfig/types/C/BTE.dt。資料類型指定由 BestTextEditor 應用程式群組所使用的圖像。動作會提供和內建應用程式群組相同的開啟與列印行為。
```
DATA_ATTRIBUTES BestTextEditorAppGroup  		
{  				
	ACTIONS		OpenInPlace,OpenNewView  
	ICON  			BTEApp  		
}
```
```
DATA_CRITERIA BestTextEditorAppGroupCriterial
{  
	DATA_ATTRIBUTES_NAME	BestTextEditorAppGroup
	MODE		d	
   PATH_PATTERN	*/appmanager/*/BestTextEditor
}
```
```
ACTION Open  		
{ 
	ARG_TYPE   BestTextEditorAppGroup
	TYPE	        MAP
	MAP_ACTION OpenAppGroup
}
```
```
ACTION Print  		
{
	ARG_TYPE   BestTextEditorAppGroup  
	TYPE	        MAP
	MAP_ACTION PrintAppGroup
}
```
3. 在將會啟動應用程式的應用程式群組中建立圖像。如果要如此作，請建立此檔案：
```
  
/desktop_approots/BTE/dt/appconfig/appmanager/C \  
    /BestTextEditor/BTEditor
```
  並使檔案成為可執行的。
4. 在將會開啟輔助說明內容的應用程式群組中建立動作檔案。如果要如此作，請建立此檔案：
```
		
/desktop_approots/BTE/dt/appconfig/appmanager/C \  
    /BestTextEditor/BTEHelp
```
  並使檔案成為可執行的。
5. 將其它檔案放在應用程式群組中；例如， "讀我 " 檔案、範例資料與樣板檔案。

註冊應用程式。

在終端機模擬器視窗中：
1. 登入為 root。
2. 執行指令：
```
/usr/dt/bin/dtappintegrate -s /desktop_approots/BTE
```
3. 開啟 Desktop_Tools 應用程式群組並連按兩下重新載入應用程式。

第 5章 註冊應用程式

應用程式註冊的概觀

由應用程式註冊所提供的功能

圖 5-1 在應用程式管理者頂層的應用程式群組

圖 5-2 包含可啟動應用程式的圖像之應用程式群組

圖 5-3 資料檔案的即現式功能表包含 ``開啟'' 與 ``列印''

應用程式註冊的目的

註冊應用程式的一般步驟

第 1 步：修改字型與色彩來源

修改字型來源

修改色彩來源

第 2 步：建立桌上管理系統應用程式 Root

第 3 步：建立註冊套裝軟體目錄

註冊套裝軟體內容

圖 5-4 在應用程式根目錄之下的註冊套裝軟體

如果要建立註冊套裝軟體

圖 5-5 應用程式管理者頂層的應用程式群組

第 4 步：建立應用程式的動作與資料類型

應用程式所需的動作與資料類型

動作與資料類型定義配置檔案的位置

圖 5-6 動作與資料類型定義檔案

建立動作與資料類型的方法

如果要使用建立動作來建立動作與資料類型

如果要人工建立動作與資料類型

第 5 步：將輔助說明檔案放在註冊套裝軟體中

第 6 步：建立應用程式的圖像

桌上管理系統所需的圖像

第 7 步：建立應用程式群組

建立應用程式群組目錄

圖 5-7 appmanager 目錄

應用程式群組名稱

圖 5-8 應用程式群組名稱（<appgroup_name>）

配置應用程式群組以使用唯一的圖像

圖 5-9 應用程式群組如何取得唯一的圖像

建立應用程式群組的內容

建立動作檔案（應用程式圖像）

圖 5-10 應用程式圖像是應用程式群組中的一個檔案

讀我檔案

建立專用的前方面板控制

第 8 步：使用 dtappintegrate 註冊應用程式

如果要註冊具有 dtappintegrate 的應用程式

dtappintegrate 的語法與選項

dtappintegrate 如何整合應用程式

動作與資料類型

輔助說明資訊檔案

圖像檔案

應用程式群組

建立註冊套裝軟體的範例

您需要知道的有關 ``BestTextEditor'' 的資訊

註冊 ``BestTextEditor'' 的步驟

第 5章註冊應用程式

圖 5-7 `appmanager` 目錄

`dtappintegrate` 的語法與選項

`dtappintegrate` 如何整合應用程式