本文會帶領插件開發人員了解如何使用 Animate CC 建立 Animate 插件,以支援自訂平台。

若要建置自訂平台支援插件,開發人員需要「自訂平台支援開發套件」。 請按一下這裡以下載。

  1. 選擇「下載」索引標籤中的「Animate 自訂平台 SDK」。
  2. 選取 CC 2019 SDK 版本
  3. 選取「跨平台」
  4. 選取要下載的「v1 (最新)」選項。

按一下這裡,下載樣本插件並做為建置自訂支援平台支援插件的參考。

  1. 選擇「下載」索引標籤中的「Animate 自訂平台 SDK」。
  2. 選取 CC 2019 SDK 版本
  3. 選取「樣本插件」

插件包含下列元素:

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

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

建立 Animate 自訂平台支援插件

您可以使用下列其中一個方法來開發自訂平台支援插件:

  • 使用自訂平台支援開發套件中的 API 來建立插件。
  • 將開發套件中包含的範例插件設定自訂為符合您的需求。

「自訂平台支援」插件會封裝為 .zxp 檔案,可與 Animate CC 一起安裝。您可以將插件裝載在 Adobe Add-ons 頁面,以供使用者使用 Creative Cloud 應用程式進行下載和安裝,或者將插件以 .zxp 套件的形式散佈,讓使用者可以使用管理擴充功能公用程式進行安裝。

 

系統需求

開發人員需要下列軟體,才能使用自訂平台支援開發套件來建置插件:

  • Microsoft Windows 7 或 Apple Mac OS 10.8 和更高版本
  • Microsoft Visual Studio 2012 (適用於 Windows) 或 XCode 4.5.2 (適用於 Mac)
  • Animate CC
  • 適用於 C/C++ 開發人員的 Eclipse IDE
  • Adobe Extension Builder 3.0
  • 管理擴充功能公用程式

插件開發人員的 API 參考文件

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

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

如需自訂平台支援中的 API 的完整資訊,以及如何使用 API 來建立插件的範例,請參閱自訂平台支援 API 參考

建立自訂平台支援插件

您可以依照下列方式建立自訂平台支援插件:

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

  5. 為您的目標平台進行必要變更。
  6. 編譯程式碼,以產生插件 (.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 編輯器)。您必須注意的兩個索引標籤是 ExtensionListDispatchInfoList

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

<ExtensionList>

        <Extension Id="PluginID" Version="1.0" />

        <Extension Id="PublishSettingsID" Version-"1.0" />

</ExtensionList>

 

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

 

  1. DispatchInfoList 標籤包含 ExtensionList 中所提到每個擴充功能的詳細資料。下列是 DispatchInfoList 的範例:
<DispatchInfoList>
            <Extension Id="PluginID">
                    <DispatchInfo >
                            <Resources>
                            <MainPath>./plugin/fcm.xml</MainPath>
                            </Resources>
                            <Lifecycle>
                            <AutoVisible>true</AutoVisible>
                            </Lifecycle>
                            <UI>
                                <Type>ModalDialog</Type>
                                <Menu>CreateJS</Menu>
                                <Geometry>
                                     <Size>
                                           <Height>200</Height>
                                           <Width>200</Width>
                                     </Size>
                                 </Geometry>
                             </UI>
                    </DispatchInfo>
        </Extension>
        <Extension Id="PublishSettingsID">
                    <DispatchInfo >
                            <Resources>
                            <MainPath>./index.html</MainPath>
                            </Resources>
                            <Lifecycle>
                                    <AutoVisible>true</AutoVisible>
                            </Lifecycle>
                            <UI>
                                    <Type>ModalDialog</Type>
                                    <Menu>Publish Settings</Menu>
                                    <Geometry>
                                         <Size>
                                                <Height>170</Height>
                                                 <Width>486</Width>
                                          </Size>
                                    </Geometry>
                            </UI>
                    </DispatchInfo>
           </Extension>
</DispatchInfoList>
     
  1. 對於包含 .dll 或 .plugin 檔案的擴充功能,您可以忽略 MainPath 標籤以外的所有標籤。MainPath 標籤包含相對於 ExtensionContent 資料夾的檔案 fcm.xml 路徑。您必須將 .dll 檔案重新命名為 .fcm,並放在 win 資料夾內,fcm.xml 旁邊。同樣地,如果您在 Mac 環境工作,請將 .plugin 檔案重新命名為 .fcm.plugin,並放在 mac 資料夾內,fcm.xml 旁邊。
  2. 用來設定發佈設定使用者介面的 HTML 擴充功能,是 Animate 的 HTML 擴充功能。若要深入了解 Animate 的 HTML 擴充功能,請參閱建立 HTML 擴充功能
  3. 確認 Host 標籤中版本屬性較低的值為 15.1,即具有自訂平台支援的 Animate CC 的最低 (內部) 版本。

<ExecutionEnvironment>
<HostList>
<Host Name="FLPR" Version="15.1" />
</HostList>.
.
.
</ExecutionEnvironment>
     
  1. 切換至「Script Explorer」(指令碼總管) 檢視,以滑鼠右鍵按一下您的專案,並選擇「Export > Adobe Extension Builder 3 > Application Extension」(匯出 > Adobe Extension Builder 3 > 應用程式擴充功能)。「Export Wizard」(匯出精靈) 隨即顯示。
  2. 您必須擁有憑證才能簽署擴充功能套件。瀏覽到現有憑證,或按一下「Create」(建立) 以建立新憑證。
  3. 按一下「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 功能要求和錯誤報告表格

此産品由 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 授權  Creative Commons 條款未涵蓋 Twitter™ 與 Facebook 文章。

法律說明   |   線上隱私權政策