啟用自訂平台的支援

搜尋

上次更新時間 2023年5月24日

Animate

開啟應用程式

Adobe Animate 使用手冊

Animate 簡介

動畫

互動

工作區和工作流程

多媒體和視訊

平台

匯出與發佈

疑難排解

本文會帶領外掛程式開發人員了解如何使用 Animate 建立 Animate 外掛程式，以支援自訂平台。

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

選擇「下載」索引標籤中的「Animate 自訂平台 SDK」。
選取 2020 SDK 版本
選取「跨平台」。
選取要下載的「Animate 20.0 (最新)」選項。

按一下這裡，下載樣本外掛程式並做為建置自訂支援平台支援外掛程式的參考。

選擇「下載」索引標籤中的「Animate 自訂平台 SDK」。
選取 2020 SDK 版本
選取「樣本外掛程式」

外掛程式包含下列元素：

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

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

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

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

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

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

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

系統需求

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

Microsoft Windows 10 (1803 和更新版本) 或 Apple Mac OS 10.13 和更新版本
Microsoft Visual Studio 2017 (適用於 Windows) 或 XCode 10.1 (適用於 Mac)
Animate
適用於 C/C++ 開發人員的 Eclipse IDE
Adobe Extension Builder 3.0
管理擴充功能公用程式

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

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

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

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

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

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

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

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

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

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

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

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

</ExtensionList>

<ExtensionList>

        <Extension Id=&quot;PluginID&quot; Version=&quot;1.0&quot; />

        <Extension Id=&quot;PublishSettingsID&quot; Version-&quot;1.0&quot; />

</ExtensionList>

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

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

<MainPath>./plugin/fcm.xml</MainPath>

</Resources>

</Lifecycle>

<UI>

<Type>ModalDialog</Type>

<Menu>CreateJS</Menu>

<Size>

</Size>

</Geometry>

</UI>

</DispatchInfo>

</Extension>

<MainPath>./index.html</MainPath>

</Resources>

</Lifecycle>

<UI>

<Type>ModalDialog</Type>

<Menu>Publish Settings</Menu>

<Size>

</Size>

</Geometry>

</UI>

</DispatchInfo>

</Extension>

</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>

<DispatchInfoList>
            <Extension Id=&quot;PluginID&quot;>
                    <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=&quot;PublishSettingsID&quot;>
                    <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>

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

<ExecutionEnvironment> <HostList> <Host Name="FLPR" Version="15.1" /> </HostList>.

</ExecutionEnvironment>

<ExecutionEnvironment> <HostList> <Host Name=&quot;FLPR&quot; Version=&quot;15.1&quot; /> </HostList>.
.
.
</ExecutionEnvironment>

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

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

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

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

如果您是想要安裝外掛程式的使用者，請使用 Animate 建立自訂平台文件並進行發佈，請參閱使用自訂平台支援外掛程式。

如需有關管理 Adobe 擴充功能的完整資訊，請參閱下載並安裝擴充功能。

功能要求和錯誤報告

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

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

更快、更輕鬆地獲得協助

新的使用者？