Kullanıcı Kılavuzu İptal

Özel Platformlar için Desteği Etkinleştirme

Ara

Son güncelleme: 25 May 2023

Bu makale, eklenti geliştiricilerine, Animate kullanarak özel platformları desteklemek için Animate eklentilerini nasıl oluşturacakları konusunda yol gösterir.

Özel platform desteği eklentisi oluşturmak için geliştiriciler Özel Platform Desteği Geliştirme Kitine ihtiyaç duyar. İndirmek içinburayı tıklatın.

İndirmeler sekmesinde Animate Özel Platform SDK'sini seçin
2020 SDK sürümünü seçin
Çapraz Platform'u seçin ve
İndirmek için Animate 20.0 (En son) seçeneğini belirleyin.

Örnek eklenti indirmek ve bunu özel destek platformu destek eklentisi oluşturmak için referans olarak kullanmak için burayı tıklatın

İndirmeler sekmesindeAnimate Özel Platform SDK'si seçeneğini belirleyin.
2020 SDK sürümünü seçin
Örnek Eklenti'yi seçin

Bir eklenti şu öğelerden oluşur:

DocType, Animate'teki özel platform için yeni bir belge türü ekler ve geliştirme özelliklerini kontrol eder.
Yayıncı, yayınlama ayarlarının yapılandırılmasına ve belgenin özel platformda yayınlanmasına olanak tanır.

Özel Platform Desteği özelliğine genel bakış için bkz. Özel Platform Desteği.

Animate özel platform desteği eklentisi oluşturma

Şu yöntemlerden birini kullanarak özel platform desteği eklentisi geliştirebilirsiniz:

Özel platform desteği geliştirme kitindeki API'leri kullanarak bir eklenti oluşturun.

Geliştirme kitindeki örnek eklentinin ayarlarını gereksinimlerinize uygun şekilde özelleştirin.

Özel Platform Desteği eklentileri, Animate ile yüklenebilecek .zxp dosyaları olarak paketlenir. Eklentiyi Adobe Add-ons sayfasında kullanıcıların indirmeleri ve Creative Cloud uygulamasını kullanarak yüklemeleri için barındırabilir veya Uzantıları Yönet yardımcı programını kullanarak yüklemeleri için eklentileri .zxp paketleri olarak dağıtabilirsiniz.

Yazılım gereksinimleri

Özel platform desteği geliştirme kitini kullanarak bir eklenti oluşturmak için bir geliştirici aşağıdaki yazılımlara ihtiyaç duyar:

Microsoft Windows 10 (1803 ve sonrası) veya Apple Mac OS 10.13 ve daha yeni sürümü
Microsoft Visual Studio 2017 (Windows için) veya XCode 10.1 (Mac için)
Animate
C/C++ Geliştiricileri için Eclipse IDE
Adobe Extension Builder 3.0
Uzantıları Yönet yardımcı programı

Eklenti geliştiricileri için API referans belgeleri

Özel platform desteği geliştirme kiti şu öğeleri içerir:

FCM (Flash Bileşen Modeli): Geliştirme kitine dahil olan üstbilgi dosyaları, eklenti yönetiminden sorumlu olan FCM adında bir çerçeve tanımlar.
DocType: Bu, Animate başlangıç sayfasına yeni bir belge türü eklemenize olanak sağlayan bir arabirim kümesi içerir ve özel belge türü için özellikleri etkinleştirmenize veya devre dışı bırakmanıza olanak sağlar.
DOM (Belge Nesnesi Modeli): Bu, DOM biçimindeki animate belgesinin içeriklerine erişmenize yardımcı olan arabirim kümesini içerir.
Yayıncı: Bu, yayınlama iş akışları için kancalar sağlayan arabirim kümesini içerir.

Özel platform desteğindeki API'ler hakkında eksiksiz bilgi ve eklentinizi oluşturmak için bunları nasıl kullanacağınıza ilişkin örnekler için bkz. Özel Platform Desteği API'si Başvurusu.

Özel platform desteği eklentisi oluşturma

Özel platform desteği eklentisini şu şekilde oluşturabilirsiniz:

Özel Platform Desteği Geliştirme Kiti'ni indirin.
Kitin içindekileri bilgisayarınıza çıkarın.
VisualStudio veya Xcode içinde yeni bir proje açın ve geliştirme kitindeki üstbilgi dosyalarını yazılım geliştirme projenize dahil edin. Özel platform desteği eklentinizi oluşturmaya hemen başlamak için SampleCreateJSPlatform dizininde bulunan örnek eklentiyi eklenti projenizin temel kodu olarak kullanabilirsiniz.

Örneğin, SampleCreateJS eklenti dosyaları şuradadır: SampleCreateJSPlatform\Plugin\SampleCreateJS\project\

Hedef platformunuz için gereken değişiklikleri yapın.
Eklentiyi oluşturmak için kodu derleyin (.dll veya .plug-in).

Özel platform desteği eklentisini paketleme

Özel platform desteği eklentisinin dağıtılabilir paketini şu şekilde oluşturabilirsiniz:

Örnek Eclipse dosyasını açın veya Eclipse Yeni Proje sihirbazında yeni bir Uygulama Uzantısı Projesi oluşturun. Proje için bir ad girin, ardından İleri'yi tıklatın.
Yeni Adobe Uygulama Uzantısı Proje panelinde hedef uygulama olarak Adobe Animate seçimini yapın ve İleri'yi tıklatın.
Oluşturduğunuz eklenti dosyalarının Windows'ta .dll olan uzantılarını .fcm olarak ve Mac'te .plug-in olan uzantılarını .fcm.plug-in olarak değiştirin ve eklenti dosyalarını projeye (Windows için ExtensionContent/plugins/lib/win ve MAC için ExtensionContent/plugins/lib/mac) ekleyin.
manifest.xml'i değiştirerek uzantınızı yapılandırın. manifest dosyasını açmak için proje gezgininde söz konusu uzantıyı sağ tıklatın ve Adobe Extension Builder 3 > Paket Yayınlama Düzenleyicisi seçeneklerini belirleyip EclipseProject\.staged-extension\CSXS konumunda mevcut Paket Yayınlama Düzenleyicisi'ndeki yayınlama sekmesini seçin.
manifest.xml düzenlemesini etkinleştirmek için pencere içinde sağ tıklatıp Şununla Aç > XML düzenleyici seçeneklerini belirleyin. Odaklanmanız gereken iki etiket şunlardır: ExtensionList ve DispatchInfoList:
Normal bir ExtensionList etiketi aşağıdaki gibi görünür:

<ExtensionList>

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

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

</ExtensionList>

Bu etiket, her bir uzantının kendi kimliği niteliğindeki benzersiz bir dizeye sahip olduğu son ZXP paketindeki uzantı listesini içerir. Bu durumda, önceki bölümde oluşturulan .dll veya .plugin dosyası bir uzantıya dahil edilir. Ardından, diğer uzantı Yayıncı'nın Yayınlama Ayarları Kullanıcı Arabirimini yapılandırma amacıyla kullanılır. ExtensionList etiketi örneğinde, PluginID uzantı kimliğine sahip uzantı .dll/.plugin dosyasını içerir ve PublishSettingsID kimliğine sahip uzantı yayıncının yayınlama ayarları kullanıcı arabirimini yapılandırır.

DispatchInfoList etiketi, ExtensionList içinde bahsedilen her bir uzantıyla ilgili ayrıntıları içerir. Aşağıdaki bir DispatchInfoList örneğidir:

<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 veya .plugin dosyasını içeren uzantı için MainPath etiketi haricindeki tüm etiketleri yoksayabilirsiniz. MainPath etiketi, ExtensionContent klasörüyle alakalı fcm.xml dosyasına giden yolu içerir. .dll dosyasını .fcm olarak yeniden adlandırmanız ve fcm.xml öğesinin yanındaki win klasörü içine yerleştirmeniz gerekir. Benzer şekilde, Mac ortamında çalışıyorsanız .plugin dosyasını .fcm.plugin olarak yeniden adlandırın ve fcm.xml öğesinin yanındaki mac klasörü içine yerleştirin.
Yayınlama ayarları kullanıcı arabirimini yapılandırmaya ilişkin HTML uzantısı, Animate'e ilişkin bir HTML uzantısıdır. Animate'e ilişkin HTML uzantıları hakkında daha fazla bilgi edinmek için bkz. HTML Uzantıları Oluşturma.
Host etiketindeki sürüm niteliğinin alt değerinin Özel Platform Desteği'ne sahip Animate minimum (dahili) sürümü 15.1 olduğundan emin olun.

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

Komut Dosyası Gezgini görünümüne geçin, projenizi sağ tıklatın ve Dışa Aktar > Adobe Extension Builder 3 > Uygulama Uzantısı seçeneklerini belirleyin. Dışa Aktarma Sihirbazı görünür.
Uzantı paketini imzalamak için bir sertifikaya sahip olmanız gerekir. Mevcut bir sertifikaya gözatın veya yeni bir sertifika oluşturmak için Oluştur'u tıklatın.
Projeyi derlemek için Son'u tıklatın. Eclipse, Adobe Add-ons sitesinde barındırabileceğiniz .zxp uzantısına sahip bir eklenti dosyası oluşturur.

Özel platform desteği eklentinizi dağıtma

Özel platform desteği eklentinizi Adobe Add-ons sayfasında barındırarak dağıtabilir ve para kazanabilirsiniz. Eklenti paketiniz sayfada listelenmeden önce bir Adobe incelemesinden ve onay sürecinden geçer. Bir eklentiyi şu şekilde barındırabilirsiniz:

Adobe kullanıcı kimliğinizi ve şifrenizi kullanarak Adobe Add-ons sayfasında oturum açın.
Soldaki panelde Üretici ol'un altındaki Üretici portalına gidin bağlantısını tıklayın.
Üretici olarak kaydolmadıysanız Kaydol düğmesini tıklayın.
Bir üretici olarak nasıl kaydolacağınız ve eklentilerinizi nasıl barındıracağınız hakkında talimatlar için Üretici Portalını Kullanmaya Başlama sayfasına bakın.
Üretici portalı iş akışında aşağıdaki adımları Başlarken sayfasında belgelendiği şekilde tamamlayın:
1. Ürününüzü tek bir dosya olarak paketleyin.
2. Ürün hakkındaki bilgileri girin ve dosyayı yükleyin.
3. Pazarlama varlıklarını ekleyin.
4. Ürününüzü önizleyin.
5. Ürününüzü onay için gönderin.
Onay sonrasında eklentiniz Add-ons sayfasındaki Animate ürün kategorisinde listelenir.

Eklenti yüklemek isteyen bir kullanıcıysanız, bir özel platform belgesi oluşturun ve Animate'i kullanarak bu belgeyi yayınlayın, bkz. Özel Platform Desteği Eklentisiyle Çalışma.