啟用自訂平台的支援

本文會帶領外掛程式開發人員了解如何建立 Animate 外掛程式，以支援使用 Animate CC 2014.2 的自訂平台。如果您使用的是 Animate CC 2014.1 (2014 年 10 月更新)，請參閱本文件的上一版。

若要建立自訂平台支援外掛程式，開發人員必須從下列位置下載「自訂平台支援開發套件」：

從下列位置下載範例外掛程式，並當做參考，用來建立自訂平台支援外掛程式：

外掛程式包含下列元素：

• DocType 會在 Animate 中加入自訂平台的新文件類型，並控制編寫功能。
• 「發佈者」允許設定發佈設定，並將文件發佈至自訂平台。

如需「自訂平台支援」功能的概觀，請參閱自訂平台支援。

Animate CC 2015 的新功能：

• 查詢元件庫元件類型的能力：若是元件，ILibraryItem::GetProperties() 會有額外的項目，其金鑰為 kLibProp_SymbolType_DictKey。金鑰的值可以是 kLibProp_SymbolType_Button、kLibProp_SymbolType_MovieClip 或 kLibProp_SymbolType_Graphic。
• 區分按鈕與 MovieClip 的能力：在上一版之前，DOM 和 IFrameCommandGenerator 服務都是將按鈕實體當做 MovieClip 來處理。自 Animate CC 2015 起，已新增了介面，可以支援按鈕實體。如果 IMovieClip 實體也實作 IButton 介面，就會被當做按鈕實體來處理。按鈕的四個狀態，也就是「一般」、「滑入」、「按下」和「感應區」，永遠分別對應到影格 0、1、2 和 3。請參閱檔案 IButton.h，深入了解按鈕實體。
• 可取得 IClassicText 物件邊界的新 API：ITimelineBuilder 介面中的 AddClassicText 功能現在會傳回 CLASSIC_TEXT_INFO_2 的物件 (而非舊的 CLASSIC_TEXT_INFO)，該物件包含新的欄位「邊界」，代表 IClassicText 物件的邊界。
• 範例外掛程式已經修改成重複使用形狀填色所用的點陣圖。
• Mongoose 網路伺服器已經整合至範例外掛程式。

注意：Animate CC 2015 版本提供的新 IK 骨塊工具，在自訂平台文件類型中是停用的。當您將 IK 內容貼到自訂平台文件時，Animate 會將內容轉換為逐格動畫。

2015 年 2 月更新：IFrameCommandGenerator 服務中的「遮色片」支援，這個版本支援 IFrameCommandGenerator 服務中的遮色片。新介面 ITimelineBuilder2 繼承自現有 ITimelineBuilder 介面，包含外掛程式必須實作才能使這個功能運作的功能。請參閱自訂平台支援 API 文件，以深入了解全新的 ITimelineBuilder2 介面。

您可以使用下列其中一個方法來開發自訂平台支援外掛程式：

• 使用自訂平台支援開發套件中的 API 來建立外掛程式。

• 將開發套件中包含的範例外掛程式設定自訂為符合您的需求。

「自訂平台支援」外掛程式會封裝為 .zxp 檔案，可與 Animate 一起安裝。您可以將外掛程式裝載在 Adobe Add-ons 頁面，以供使用者使用 Creative Cloud 應用程式進行下載和安裝，或者將外掛程式以 .zxp 套件的形式散佈，讓使用者可以使用 Adobe Extensions Manager 進行安裝。

系統需求

開發人員需要下列軟體，才能使用自訂平台支援開發套件來建置外掛程式：

• Microsoft Windows 7 或 Apple Mac OS 10.8 和更高版本
• Microsoft Visual Studio 2012 (適用於 Windows) 或 XCode 4.5.2 (適用於 Mac)
• Animate CC 2014.1 及更新版本
• 適用於 C/C++ 開發人員的 Eclipse IDE
  
• Adobe Extension Builder 3.0
• Adobe Extension Manager 7.2.1.6

外掛程式開發人員的 API 參考文件

自訂平台支援開發套件包含下列元素：

• FCM (Flash 組件模型)：包含在開發套件中的標題檔案會定義名為 FCM 的架構，此架構是用於外掛程式管理。
• DocType：這個元素包含一組介面，可協助您將新的文件類型加入 Animate 開始頁面，並讓您可以針對自訂文件類型啟用或停用功能。
• DOM (文件物件模型)：這個元素包含一組介面，可協助您存取使用 DOM 格式的 Animate 文件中的內容。 
• 發佈者：這個元素包含一組介面，提供發佈工作流程的攔截程序。

如需自訂平台支援中的 API 的完整資訊，以及如何使用 API 來建立外掛程式的範例，請參閱自訂平台支援 API 參考。

建立自訂平台支援外掛程式

您可以依照下列方式建立自訂平台支援外掛程式：

1. 下載「自訂平台支援開發套件」。
2. 將套件內容解壓縮到您的電腦。
3. 在 VisualStudio 或 Xcode 中開啟新專案，並將開發套件中的標題檔案納入您的軟體開發專案。若要快速建立您的自訂平台支援外掛程式，您可以使用 SampleCreateJSPlatform 目錄下方的下列範例外掛程式，做為外掛程式專案的基礎程式碼。

            例如，SampleCreateJS 外掛程式檔案位於                        SampleCreateJSPlatform\Plugin\SampleCreateJS\project\

4. 為您的目標平台進行必要變更。
5. 編譯程式碼，以產生外掛程式 (.dll 或 .plug-in)。 

封裝自訂平台支援外掛程式

您可以依照下列方式，為自訂平台支援外掛程式產生可散佈的套件：

1. 開啟範例 Eclipse 檔案，或者在 Eclipse 的「New Project wizard」(新增專案精靈) 中，建立新的應用程式擴充功能專案。為專案提供名稱，然後按一下「Next」(下一步)。
2. 在「New Adobe Application Extension Project」(新增 Adobe 應用程式擴充功能專案) 面板上，選擇「Adobe Animate」做為目標應用程式，並按一下「Next」(下一步)。
3. 在 Windows 上，將您所建立的外掛程式檔案的副檔名從 .dll 變更為 .fcm，或在 Mac 上，將副檔名從 .plug-in 變更為 .fcm.plug-in，然後將外掛程式檔案加入專案 (Windows：ExtensionContent/plugins/lib/win，MAC：ExtensionContent/plugins/lib/mac)。
4. 修改 manifest.xml，以設定您的擴充功能。 若要開啟資訊清單檔案，請以滑鼠右鍵按一下專案總管中的擴充功能，並選取「Adobe Extension Builder 3 > Bundle Manifest Editor」(合併資訊清單編輯器)，然後選取位於 EclipseProject\.staged-extension\CSXS 之「Bundle Manifest Editor」(合併資訊清單編輯器) 中的資訊清單索引標籤。
5. 若要允許編輯 manifest.xml，請在視窗內以滑鼠右鍵按一下，並選取「Open with > XML editor」(開啟方式 > XML 編輯器)。您必須注意的兩個索引標籤是 ExtensionList 和 DispatchInfoList：

   典型的 ExtensionList 標籤看起來如下：

這個標籤包含最終 ZXP 套件中擴充功能的清單，其中每個擴充功能都有唯一的字串做為其 ID。在這個情況中，先前章節中建立的 .dll 或 .plugin 檔案會包含在擴充功能。然後，其他擴充功能可用來設定「發佈者」的「發佈設定」UI。在 ExtensionList 標籤的範例中，擴充功能 ID 為 PluginID 的擴充功能包含 .dll/.plugin 檔案，而擴充功能 ID 為 PublishSettingsID 的擴充功能會設定發佈者的發佈設定 UI。

6. DispatchInfoList 標籤包含 ExtensionList 中所提到每個擴充功能的詳細資料。下列是 DispatchInfoList 的範例：

 
7. 對於包含 .dll 或 .plugin 檔案的擴充功能，您可以忽略 MainPath 標籤以外的所有標籤。MainPath 標籤包含相對於 ExtensionContent 資料夾的檔案 fcm.xml 路徑。您必須將 .dll 檔案重新命名為 .fcm，並放在 win 資料夾內，fcm.xml 旁邊。同樣地，如果您在 Mac 環境工作，請將 .plugin 檔案重新命名為 .fcm.plugin，並放在 mac 資料夾內，fcm.xml 旁邊。
8. 用來設定發佈設定使用者介面的 HTML 擴充功能，是 Animate 的 HTML 擴充功能。若要深入了解 Animate 的 HTML 擴充功能，請參閱建立 HTML 擴充功能。
9. 確認 Host 標籤中版本屬性較低的值為 14.1，即具有自訂平台支援的 Animate 的最低 (內部) 版本。
   
   

 
10. 切換至「Script Explorer」(指令碼總管) 檢視，以滑鼠右鍵按一下您的專案，並選擇「Export > Adobe Extension Builder 3 > Application Extension」(匯出 > Adobe Extension Builder 3 > 應用程式擴充功能)。「Export Wizard」(匯出精靈) 隨即顯示。
11. 您必須擁有憑證才能簽署擴充功能套件。瀏覽到現有憑證，或按一下「Create」(建立) 以建立新憑證。
12. 按一下「Finish」(完成) 以編譯專案。Eclipse 隨即產生副檔名為 .zxp 的外掛程式檔案，以供您裝載在 Adobe Add-ons 網站上。

散佈您的自訂平台支援外掛程式

您可以將自訂平台支援外掛程式裝載在 Adobe Add-ons 頁面，藉此散佈並獲利。您的外掛程式套件將經過 Adobe 審核及核准程序，然後才會列在頁面中。您可以依照下列方式裝載外掛程式：

1. 使用您的 Adobe 使用者 ID 和密碼登入 Adobe Add-ons 頁面。
2. 在左側面板的「成為製作人」下方，按一下連結前往製作人入口網站。
3. 如果您尚未註冊成為製作人，請按一下「Sign-up」(註冊) 按鈕。
4. 如需有關如何註冊成為製作人及裝載外掛程式的詳細指示，請參閱製作人入口網站快速入門。
5. 依照快速入門頁面所述，完成製作人入口網站工作流程中的下列步驟。
   1. 以單一檔案封裝您的產品。
   2. 輸入產品相關資訊並上傳檔案。
   3. 加入行銷資源。
   4. 預覽您的產品。
   5. 提交您的產品，以供核准。
6. 核准之後，您的外掛程式就會列在 Add-ons 頁面的 Animate 產品類別下方。 

功能要求和錯誤報告

如果您要傳送任何問題、疑慮、產品錯誤或功能要求給 Animate 產品團隊，請填寫下列表格：

Adobe 功能要求和錯誤報告表格