舊文件

此處文件僅供參考,請自行考量時效性與適用程度,其他庫藏文件請參考文件頁面
我們亟需您的協助,進行共筆系統搬移、及文件整理工作,詳情請查閱參與我們

「如何撰寫install.rdf」修訂間的差異

出自 MozTW Wiki

 
install.rdf 範例
行 52: 行 52:
 
</pre>
 
</pre>
 
*一定要寫的標籤
 
*一定要寫的標籤
#<em:id>: 這是用來指定你的套件的 UID,那麼你要怎麼取得 UID 呢? 這裡有三套工具可以用 guidgen (Windows), uuidgen (Unix/Linux), "botbot uuid" (在IRC上)
+
#em:id - 這是用來指定你的套件的 UID,那麼你要怎麼取得 UID 呢? 這裡有三套工具可以用 guidgen (Windows), uuidgen (Unix/Linux), "botbot uuid" (在IRC上)
#<em:version>: 指定你套件的版本號
+
#<em:version> - 指定你套件的版本號
 
#<em:targetApplication>: 這個部份指明你要安裝套件的是那個應用程式,例如:Firefox 或 mozilla
 
#<em:targetApplication>: 這個部份指明你要安裝套件的是那個應用程式,例如:Firefox 或 mozilla
#*<em:id>: 這裡的 id 是固定的哦
+
#*em:id - 這裡的 id 是固定的哦
 
#**Firefox:{ec8030f7-c20a-464f-9b0e-13a3a9e97384}
 
#**Firefox:{ec8030f7-c20a-464f-9b0e-13a3a9e97384}
 
#**Mozilla:{86c18b42-e466-45a9-ae7a-9b95ba6f5640}
 
#**Mozilla:{86c18b42-e466-45a9-ae7a-9b95ba6f5640}
 
#**Thunderbird:{3550f703-e582-4d05-9a08-453d09bdfdc6}
 
#**Thunderbird:{3550f703-e582-4d05-9a08-453d09bdfdc6}
#*<em:minVersion>, <em:maxVersion>: 最小相容版和最大相容版本
+
#*em:minVersion, em:maxVersion - 最小相容版和最大相容版本
#<em:name>: 擴充套件的名稱
+
#em:name - 擴充套件的名稱
#<em:file>: 指定 chrome 裡頭檔案的安裝目錄
+
#em:file - 指定 chrome 裡頭檔案的安裝目錄
#*<Description about="urn:mozilla:extension:file:moztwPack.jar">: 注意,這裡的 moztwPack.jar 要替換成你包好的套件,可不要照抄吶。
+
#*Description about="urn:mozilla:extension:file:moztwPack.jar" - 注意,這裡的 moztwPack.jar 要替換成你包好的套件,可不要照抄吶。
#*<em:package>: 指定安裝 content/ 裡的檔案
+
#*em:package - 指定安裝 content/ 裡的檔案
#*<em:skin>: 指定安裝 skin/ 裡的檔案
+
#*em:skin - 指定安裝 skin/ 裡的檔案
#*<em:locale>: 指定安裝 locale/ 裡的檔案
+
#*em:locale - 指定安裝 locale/ 裡的檔案
  
 
*不一定要寫的標籤
 
*不一定要寫的標籤
 +
#em:description - 簡介你的套件功能之類的。
 +
#em:creator - 開發者的名稱
 +
#em:contributor - 發行人的名稱
 +
#em:homepageURL - 首頁的網址
 +
#em:updateURL - 這個標籤可以讓你的套件自動從網站上做更新的動作,因為我實際上沒用過這個功能,有用過的麻煩補充更詳細的資訊吧 :)
 +
#em:optionsURL - 還記得擴充套件管理員有個 "選項" 的設定功能嗎? 他就是利用這個標籤做。例如:<em:optionsURL>chrome://moztwPack/content/options.xul</em:optionsURL>
 +
#em:aboutURL - 同上,直接連到 about 視窗 例如:<em:aboutURL>chrome://myext/content/about.xul</em:aboutURL>
 +
#em:iconURL - 顯示你的套件 icon 例如:<em:iconURL>chrome://myext/skin/icon.png</em:iconURL>

於 2005年4月19日 (二) 17:22 的修訂

install.rdf 範例

這裡我們先給一個樣板:

<!-- 宣告區 -->
<?xml version="1.0"?>
<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
     xmlns:em="http://www.mozilla.org/2004/em-rdf#">

<!-- 主要內容 -->
  <Description about="urn:mozilla:install-manifest">

    <em:id>{c7ae9c4d-e8f5-4a01-8ec9-1233018a202e}</em:id>
    <em:version>0.1</em:version>

    <!-- 指明要安裝套件的應用程式,這個例子是 Firefox -->
    <em:targetApplication>
      <Description>
        <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id>
        <em:minVersion>0.10</em:minVersion>
        <em:maxVersion>1.0+</em:maxVersion>
      </Description>
    </em:targetApplication>
    
    <!-- 套件資訊 -->
    <em:name>Moztw Pack</em:name>
    <em:description>Moztw 自訂的套件</em:description>
    <em:creator>Moztw</em:creator>
    <em:contributor>dken</em:contributor>
    <em:homepageURL>http://moztw.org/</em:homepageURL>

    <!-- 安裝檔案 -->
    <em:file>
      <Description about="urn:mozilla:extension:file:moztwPack.jar">
        <em:package>content/moztwPack/</em:package>
        <em:skin>skin/classic/moztwPack/</em:skin>
        <em:locale>locale/zh-TW/moztwPack/<em:locale>
      </Description>
    </em:file>

  </Description>      
</RDF>
  • 宣告區:這個部份是固定的,只要照抄即可
  • 主要內容:

這個部份頭尾的 <Description> 標籤寫法都是固定,而其中的 properties 的部份則可以視我們的需要來改變,但是有幾個必要的 properties 是一定要寫的,接下來會介紹。

<Description about="urn:mozilla:install-manifest">
     ...
     [properties]
     ...
</Description>
  • 一定要寫的標籤
  1. em:id - 這是用來指定你的套件的 UID,那麼你要怎麼取得 UID 呢? 這裡有三套工具可以用 guidgen (Windows), uuidgen (Unix/Linux), "botbot uuid" (在IRC上)
  2. <em:version> - 指定你套件的版本號
  3. <em:targetApplication>: 這個部份指明你要安裝套件的是那個應用程式,例如:Firefox 或 mozilla
    • em:id - 這裡的 id 是固定的哦
      • Firefox:{ec8030f7-c20a-464f-9b0e-13a3a9e97384}
      • Mozilla:{86c18b42-e466-45a9-ae7a-9b95ba6f5640}
      • Thunderbird:{3550f703-e582-4d05-9a08-453d09bdfdc6}
    • em:minVersion, em:maxVersion - 最小相容版和最大相容版本
  4. em:name - 擴充套件的名稱
  5. em:file - 指定 chrome 裡頭檔案的安裝目錄
    • Description about="urn:mozilla:extension:file:moztwPack.jar" - 注意,這裡的 moztwPack.jar 要替換成你包好的套件,可不要照抄吶。
    • em:package - 指定安裝 content/ 裡的檔案
    • em:skin - 指定安裝 skin/ 裡的檔案
    • em:locale - 指定安裝 locale/ 裡的檔案
  • 不一定要寫的標籤
  1. em:description - 簡介你的套件功能之類的。
  2. em:creator - 開發者的名稱
  3. em:contributor - 發行人的名稱
  4. em:homepageURL - 首頁的網址
  5. em:updateURL - 這個標籤可以讓你的套件自動從網站上做更新的動作,因為我實際上沒用過這個功能,有用過的麻煩補充更詳細的資訊吧 :)
  6. em:optionsURL - 還記得擴充套件管理員有個 "選項" 的設定功能嗎? 他就是利用這個標籤做。例如:<em:optionsURL>chrome://moztwPack/content/options.xul</em:optionsURL>
  7. em:aboutURL - 同上,直接連到 about 視窗 例如:<em:aboutURL>chrome://myext/content/about.xul</em:aboutURL>
  8. em:iconURL - 顯示你的套件 icon 例如:<em:iconURL>chrome://myext/skin/icon.png</em:iconURL>
個人工具