Włączanie obsługi platform niestandardowych

Szukaj

Ostatnia aktualizacja 25 maj 2023

Animate

Otwórz aplikację

Podręcznik użytkownika programu Adobe Animate

Wprowadzenie do programu Animate

Animacja

Funkcje interaktywne

Przestrzeń robocza i obieg pracy

Multimedia i wideo

Platformy

Eksportowanie i publikowanie

Rozwiązywanie problemów

Ten artykuł zawiera wskazówki dla programistów wtyczek dotyczące tworzenia wtyczek do programu Animate w celu zapewnienia obsługi platform niestandardowych.

Aby utworzyć wtyczkę obsługującą platformę niestandardową, programista musi pobrać zestaw SDK obsługi platform niestandardowych. Kliknij tutaj, aby go pobrać.

Wybierz zestaw SDK obsługi platform niestandardowych w programie Animate na zakładce Downloads (Pliki do pobrania).
Wybierz wersję zestawu SDK 2020.
Wybierz opcję Cross Platform (Wiele platform).
Wybierz opcję Animate 20.0 (najnowszy), aby pobrać.

Kliknij tutaj, aby pobrać przykładową próbkę i użyć jej jako odniesienia podczas pracy nad wtyczką obsługi platformy niestandardowej.

Wybierz opcję Animate Custom Platform SDK (Zestaw SDK obsługi platform niestandardowych w programie Animate) na zakładce Downloads (Pliki do pobrania).
Wybierz wersję zestawu SDK 2020.
Wybierz opcję Sample Plug-in (Wtyczka przykładowa).

Wtyczka ta składa się z następujących elementów:

Klasa DocType dodaje nowy typ dokumentu własnej platformy w programie Animate i steruje funkcjami tworzenia treści.
Klasa Publisher umożliwia konfigurowanie ustawień publikowania i publikowanie dokumentu na własnej platformie.

Omówienie funkcji obsługi platform niestandardowych można znaleźć w artykule Obsługa platform niestandardowych.

Tworzenie wtyczki obsługi własnej platformy Animate

Aby utworzyć wtyczkę obsługi platformy niestandardowej, można użyć jednej z następujących metod:

Utwórz wtyczkę przy użyciu interfejsów API dostępnych w zestawie SDK obsługi platform niestandardowych.

Dostosuj w odpowiedni sposób ustawienia wtyczki przykładowej dołączonej do zestawu SDK.

Wtyczki obsługi platform niestandardowych pakuje się jako pliki ZXP, które można instalować w programie Animate. Wtyczkę można umieścić na stronie dodatków firmy Adobe, aby użytkownicy mogli pobierać ją i instalować za pomocą aplikacji Creative Cloud. Można też rozpowszechniać wtyczki jako pakiety ZXP do instalowania przy użyciu narzędzia Zarządzaj rozszerzeniami.

Wymagania dotyczące oprogramowania

Do tworzenia wtyczek przy użyciu zestawu SDK obsługi platform niestandardowych programista potrzebuje następujących narzędzi:

Microsoft Windows 10 (1803 i nowsze wersje) lub Apple macOS 10.13 i nowsze wersje
Microsoft Visual Studio 2017 (Windows) lub XCode 10.1 (macOS)
Animate
Środowisko programistyczne Eclipse dla programistów C/C++
Adobe Extension Builder 3.0
Narzędzie Zarządzaj rozszerzeniami

Dokumentacja interfejsów API dla programistów wtyczek

Zestaw SDK obsługi platform niestandardowych zawiera następujące elementy:

FCM (Flash Component Model): Pliki nagłówków zawarte w zestawie SDK definiują platformę określaną jako FCM, która obsługuje zarządzanie wtyczkami.
DocType: Zawiera zestaw interfejsów, które ułatwiają dodanie nowego typu dokumentów do strony startowej programu Animate, a także pozwalają włączać i wyłączać funkcje dla własnego typu dokumentów.
DOM (Document Object Model): Obejmuje zestaw interfejsów umożliwiających uzyskiwanie dostępu do zawartości dokumentu Animate jako obiektów DOM.
Publisher: Obejmuje zestaw interfejsów z uchwytami do obiegów pracy publikowania.

Szczegółowe informacje o interfejsach API do obsługi platform niestandardowych wraz z przykładami ich użycia we wtyczkach można znaleźć w dokumentacji interfejsów API obsługi platform niestandardowych.

Tworzenie wtyczki obsługi platformy niestandardowej

Wtyczkę obsługi platformy niestandardowej można utworzyć w następujący sposób:

Pobierz zestaw SDK obsługi platform niestandardowych.
Wyodrębnij zawartość zestawu na komputer.
Otwórz nowy projekt w programie VisualStudio lub Xcode i dołącz pliki nagłówków z zestawu SDK do projektu w środowisku programistycznym. Aby szybko przejść do tworzenia wtyczki obsługi platformy niestandardowej, można użyć wtyczki przykładowej dostępnej w katalogu SampleCreateJSPlatform jako kodu podstawowego projektu wtyczki.

Pliki wtyczki SampleCreateJS znajdują się w lokalizacji: SampleCreateJSPlatform\Plugin\SampleCreateJS\project\

Wprowadź wymagane zmiany platformy docelowej.
Skompiluj kod w celu wygenerowania wtyczki (z rozszerzeniem DLL lub PLUG-IN).

Pakowanie wtyczki obsługi platformy niestandardowej

W następujący sposób można wygenerować pakiet do rozpowszechniania wtyczki obsługi platformy niestandardowej:

Otwórz przykładowy plik środowiska Eclipse lub uruchom kreator nowego projektu w środowisku Eclipse i utwórz nowy projekt rozszerzenia aplikacji. Wprowadź nazwę projektu, a następnie kliknij przycisk Dalej.
W panelu projektu rozszerzenia nowej aplikacji Adobe wybierz opcję Adobe Animate jako aplikację docelową i kliknij przycisk Dalej.
Zmień rozszerzenia utworzonych plików wtyczki z DLL na FCM (Windows) i z PLUG-IN na FCM.PLUG-IN (Mac OS), a następnie dodaj pliki wtyczki do projektu (ExtensionContent/plugins/lib/win w systemie Windows lub ExtensionContent/plugins/lib/mac w systemie Mac OS).
Skonfiguruj rozszerzenie, modyfikując plik manifest.xml.Aby otworzyć plik manifestu, kliknij rozszerzenie prawym przyciskiem myszy w eksploratorze projektu, wybierz polecenie Adobe Extension Builder 3 > Bundle Manifest Editor (Edytor manifestu pakietu), a następnie wybierz w edytorze manifestu pakietu zakładkę Manifest w drzewie EclipseProject\.staged-extension\CSXS.
Aby włączyć edytowanie pliku manifest.xml, kliknij prawym przyciskiem myszy w oknie i wybierz polecenie Open with (Otwórz za pomocą) > XML editor (Edytor XML). Największe znaczenie mają znaczniki ExtensionList i DispatchInfoList:
Typowy znacznik ExtensionList ma następującą postać:

</ExtensionList>

<ExtensionList>

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

        <Extension Id=&quot;IDUstawieńPublikowania&quot; Version-&quot;1.0&quot; />

</ExtensionList>

Ten znacznik zawiera listę rozszerzeń w wynikowym pakiecie ZXP, na której każde rozszerzenie ma identyfikator będący niepowtarzalnym ciągiem. W tym przypadku plik DLL lub PLUGIN utworzony w poprzedniej sekcji jest dołączany do rozszerzenia. Następnie interfejs ustawień publikowania wydawcy jest konfigurowany za pomocą innego rozszerzenia. W tym przykładzie znacznik ExtensionList definiuje rozszerzenie o identyfikatorze IDWtyczki z plikiem DLL/PLUGIN i rozszerzenie o identyfikatorze Identyfikator ustawień publikowania konfigurujące interfejs ustawień publikowania wydawcy.

Znacznik DispatchInfoList zawiera szczegółowe dane rozszerzeń wymienionych w znaczniku ExtensionList. Poniżej podano przykład znacznika 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="IDWtyczki"> <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="IDUstawieńPublikowania"> <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;IDWtyczki&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;IDUstawieńPublikowania&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>

Gdy rozszerzenie zawiera plik DLL lub PLUGIN, można zignorować wszystkie znaczniki oprócz znacznika MainPath. Znacznik MainPath zawiera ścieżkę do pliku fcm.xml określoną względem folderu ExtensionContent. Zmień rozszerzenie pliku DLL na CFM i umieść go w folderze win razem z plikiem fcm.xml. W środowisku Mac OS zmień rozszerzenie pliku z PLUGIN na FCM.PLUGIN i umieść go w folderze mac razem z plikiem fcm.xml.
Rozszerzenie HTML konfigurujące interfejs użytkownika ustawień publikowania jest rozszerzeniem HTML programu Animate. Więcej informacji o rozszerzeniach HTML programu Animate można znaleźć w artykule Tworzenie rozszerzeń HTML.
Upewnij się, że niższa wartość atrybutu version w znaczniku Host wynosi 15.1. Jest to minimalna (wewnętrzna) wersja programu Animate z obsługą platform niestandardowych.

</HostList>.

</ExecutionEnvironment>

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

Przejdź do widoku Eksplorator skryptów, kliknij prawym przyciskiem myszy projekt i wybierz opcję Eksportuj > Adobe Extension Builder 3 > Rozszerzenie aplikacji. Zostanie wyświetlony kreator eksportowania.
Aby móc podpisać pakiet rozszerzenia, trzeba mieć certyfikat. Przejdź do istniejącego certyfikatu lub kliknij opcję Utwórz, aby utworzyć nowy certyfikat.
Kliknij przycisk Zakończ, aby skompilować projekt. Środowisko Eclipse wygeneruje plik wtyczki z rozszerzeniem ZXP, który można umieścić w witrynie dodatków firmy Adobe.

Rozpowszechnianie wtyczki obsługi platformy niestandardowej

Aby rozpowszechnić wtyczkę obsługi własnej platformy, można umieścić ją na stronie dodatków firmy Adobe z opcją zakupu. Pakiet wtyczki jest sprawdzany przez firmę Adobe — przechodzi przez proces zatwierdzania przed umieszczeniem go na stronie. Wtyczkę można umieścić na stronie w następujący sposób:

Zaloguj się na stronie dodatków firmy Adobe przy użyciu identyfikatora użytkownika i hasła konta Adobe.
W lewym panelu w kategorii Become a producer (Zostań producentem) kliknij łącze Go to the producer portal (Przejdź do portalu producentów).
Kliknij przycisk Sign-up (Zarejestruj się), jeśli nie masz jeszcze konta producenta.
Szczegółowe instrukcje na temat rejestrowania się jako producent i umieszczania wtyczek na stronie można znaleźć w artykule Pierwsze kroki z portalem producentów.
Wykonaj czynności obiegu pracy z portalem producentów omówione na stronie Pierwsze kroki:
1. Spakuj produkt do jednego pliku.
2. Wprowadź informacje o produkcie i wyślij plik.
3. Dodaj zasoby reklamowe.
4. Wyświetl podgląd produktu.
5. Wyślij produkt do zatwierdzenia.
Po zatwierdzeniu wtyczka zostanie umieszczona w kategorii produktów Animate na stronie dodatków.

Jeśli jako użytkownik chcesz zainstalować wtyczkę, utworzyć dokument platformy niestandardowej i opublikować go za pomocą programu Animate, zapoznaj się z artykułem Praca z wtyczkami obsługi platform niestandardowych.

Szczegółowe informacje o zarządzaniu rozszerzeniami produktów firmy Adobe można uzyskać w artykule Pobieranie i instalowanie rozszerzeń.

Zgłaszanie błędów i propozycji funkcji

Wypełniając poniższy formularz, można wysłać do zespołu produktu Animate pytania, sugestie, informacje o błędach lub propozycje funkcji:

Formularz zgłaszania błędów i propozycji funkcji w produktach firmy Adobe

Pomoc dostępna szybciej i łatwiej

Nowy użytkownik?