Bu makale, eklenti geliştiricilerine Animate CC 2014.2 kullanarak özel platformları desteklemek için Animate eklentilerini nasıl oluşturacakları konusunda yol gösterir. Animate CC 2014.1 (Ekim 2014 güncellemesi) kullanıyorsanız bu belgenin önceki sürümüne bakın.
Özel platform desteği eklentisi oluşturmak için geliştiriciler şu konumdan Özel Platform Desteği Geliştirme Kiti'ni indirmelidir:
İndir
Aşağıdaki konumdan bir örnek eklenti indirin ve bunu özel destek platformu destek eklentisi oluşturmak için referans olarak kullanın:
İndir
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 CC 2015'teki Yenilikler:
- Bir kütüphane sembolünün türünü sorgulama özelliği: Semboller söz konusu olduğunda, ILibraryItem::GetProperties() içerisinde, tuş ile kLibProp_SymbolType_DictKey şeklinde ek bir giriş olacaktır. Tuşun değeri kLibProp_SymbolType_Button, kLibProp_SymbolType_MovieClip, veya kLibProp_SymbolType_Graphic olabilir.
- Düğme ve MovieClip ayrımı yapabilme özelliği: Önceki sürüme kadar, düğme örnekleri, hem DOM hem de IFrameCommandGenerator hizmeti tarafından MovieClips olarak kabul edilirdi. Animate CC 2015'ten itibaren, düğme örneklerini desteklemek üzere bir arabirim eklenmiştir. Eğer IMovieClip örneği, IButton arabirimini de uygularsa, düğme örneği olarak kabul edilir. Yukarı, Üzerinde, Aşağı ve Vuruş gibi, bir düğmenin dört durumu her zaman sırasıyla kare 0, 1, 2 ve 3 ile eşlenir. Düğme örneği hakkında daha fazla bilgi almak için IButton.h dosyasına bakın.
- IClassicText nesnelerinin sınırlarını almak için yeni API: ITimelineBuilder arabirimindeki AddClassicText işlevi artık IClassicText nesnesinin sınırlarını temsil eden yeni bir alan "sınırlarını" içeren CLASSIC_TEXT_INFO_2 (eski CLASSIC_TEXT_INFO yerine) nesnesini geri döndürür.
- Bu örnek eklenti, şekil dolguları için kullanılan bitmap'ler yeniden kullanılacak şekilde değiştirilmiştir.
- Mongoose web sunucusu, örnek eklentiye entegre edilmiştir.
Not: Animate CC 2015 sürümünde kullanılabilen yeni TK eklem aracı, Özel Platform belge türlerinde devre dışıdır. TK içeriği artık, özel bir platform belgesine yapıştırdığınızda Animate tarafından kare kare animasyona dönüştürülür.
Şubat 2015 güncellemesi: IFrameCommandGenerator hizmetinde “maskeler” için destek --Bu sürüm, IFrameCommandGenerator hizmetinde maskeleri destekler. Mevcut ITimelineBuilder arabiriminden devralınan yeni arabirim ITimelineBuilder2, bu özelliğin çalışması için eklentinin uygulaması gereken işlevleri içerir. Yeni ITimelineBuilder2 arabirimi
hakkında daha fazla bilgi almak için bkz. Özel Platform Desteği API'si belgeleri.
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üklelemeri için barındırabilir veya Adobe Extension Manager 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 7 veya Apple Mac OS 10.8 ve daha yeni sürümü
- Microsoft Visual Studio 2012 (Windows için) veya XCode 4.5.2 (Mac için)
- Animate CC 2014.1 ve üstü
- C/C++ Geliştiricileri için Eclipse IDE
- Adobe Extension Builder 3.0
- Adobe Extension Manager 7.2.1.6
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.
- Hedef platformunuz için gereken değişiklikleri yapın.
- Eklentiyi oluşturmak için kodu derleyin (.dll veya .plug-in).
Örneğin, SampleCreateJS eklenti dosyaları şuradadır: SampleCreateJSPlatform\Plugin\SampleCreateJS\project\
Ö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="PluginID" Version="1.0" />
<Extension Id="PublishSettingsID" Version-"1.0" />
</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="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>
- .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ü 14.1 olduğundan emin olun.
<ExecutionEnvironment> <HostList> <Host Name="FLPR" Version="15.0" /> </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 olun altındaki Üretici portalına gidin bağlantısını tıklatın.
- Üretici olarak kaydolmadıysanız Kaydol düğmesini tıklatı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:
- Ürününüzü tek bir dosya olarak paketleyin.
- Ürün hakkındaki bilgileri girin ve dosyayı yükleyin.
- Pazarlama varlıklarını ekleyin.
- Ürününüzü önizleyin.
- Ü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.
- Adobe uzantılarını yönetme hakkında eksiksiz bilgiler için bkz. Uzantıları İndirme ve Yükleme.
Özellik istekleri ve hata bildirimi
Animate ürün ekibine herhangi bir soru, sorun, ürün hatası veya özellik isteği göndermek istiyorsanız aşağıdaki formu doldurun:
