HTML uzantıları oluşturma

Animate, HTML uzantıları kullanılarak genişletilebilir. Adobe Extension Builder 3, Animate için HTML uzantıları oluşturmanızı sağlar. Eskiden yalnızca SWF uzantılarını kullanarak Animate'i genişletmeniz mümkündü. Ancak, Adobe Extension Builder 3 sayesinde Creative Cloud uygulamaları için HTML uzantıları oluşturabilirsiniz. Başlamak için Eclipse ve Extension Builder 3.0'ı indirip yüklemeniz gerekir.

Bir HTML uzantısı oluşturmak için şunları yapın.

1. Eclipse'i başlatın. 
2. Yeni Proje sihirbazında, yeni bir Uygulama Uzantısı Projesi oluşturun. Proje için anlamlı bir ad girin, ardından İleri'yi tıklatın.
3. Yeni Adobe Uygulama Uzantısı Proje panelinde, Adobe Animate'i seçin. İleri'yi tıklatın.
4. Mevcut seçenekleri kullanarak uzantınızı yapılandırın:
   
   1. Paket Kimliği uzantınızı tanımlayan benzersiz bir kimliktir.
   2. Menü adı uzantınızın görüntülenen adıdır. Animate içinde, Menü Adı Pencere > Uzantılar menüsünde görüntülenir.
      
   3. Pencere Ayrıntıları Uzantı pencere türünü ve büyüklüğünü özelleştirmek için bu seçenekleri kullanın.
      
      İleri'yi tıklatın.
5. Uzantınızla bağlantılı başvuru kütüphanelerini gelecek birkaç ekranda daha da özelleştirebilirsiniz:
   1. CEP Kullanıcı Arabirimi Kütüphanesi barındırılan uygulamayla etkileşim için işlevler sağlar. Bu seçenek varsayılan olarak seçilidir.
   2. Çerçeveler, jQuery gibi Javascript kütüphanelerinde yaygındır.
      
   3. Servisler; Adobe uygulamaları, uzantılar ve harici uygulamalar arasında iletişimi sağlayan Adobe IPC İletişim Araç Seti'ni içerir. Creative Cloud iletişimlerinde bir merkez işlevi gören CEP Service Manager yoluyla mesajlaşma yapılabilmesi için bir protokol sağlar.
      
      Yeni bir Eclipse projesi oluşturmak için Bitir'i tıklayın.

Animate'te uzantınızla ilgili hataları ayıklama 

Uzantınızı doğrudan Eclipse'ten çalıştırabilirsiniz:

1. Projeyi sağ tıklatın ve Farklı Çalıştır > Adobe Flash Uzantısı seçeneklerini belirleyin. Bu işlem, Animate'i başlatır.
2. Animate'te, Pencere > Uzantılar menü öğesini seçin. Bu işlemle uzantı paneli açılır.

Uzantınızı dışa aktarma

Uzantınızı dağıtmak için öncelikle uzantıyı bir ZXP paketi olarak dışa aktarmanız gerekir. ZXP paketi daha sonra Adobe Extension Manager tarafından indirilir ve Creative Cloud uygulamalarında çalıştırılır:

1. Eclipse'te Komut Dosyası Gezgini görünümüne geçip projenizi sağ tıklatın, ardından Dışa Aktar > Adobe Extension Builder 3 > Uygulama Uzantısı seçeneklerini belirleyin. Bu işlemle Dışa Aktarma Sihirbazı görüntülenir.
2. 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.
3. Bitir'i tıklatın.
4. Dışa aktarma işlemi tamamlandığı zaman, uzantınıza ait olan ve dağıtıma hazır haldeki ZXP paketini proje klasörünüzde bulacaksınız.

Not: Yüklemek için, <extension>\.staged-extension\CSXS\manifest.xml dosyasına erişmeniz ve en düşük Animate sürümünü 13.0'a ayarlamak için host etiketini güncellemeniz gerekir.

Animate'te uzantınızı yükleme 

Animate'te Adobe Extension Manager'ı kullanarak HTML uzantılarını yükleyebilirsiniz. HTML uzantıları, Animate işlevlerini ve özelliklerini genişletmenize yardımcı olabilir.

HTML uzantılarına etkileşim ekleme

Kontrol ekleme, davranış belirleme ve ana bilgisayar (Animate ve işletim sistemi dahil) ortamıyla ilgili bilgi edinme yoluyla, Animate ile etkileşimde bulunacak bir HTML uzantısı geliştirebilirsiniz. Bu işlem iki yolla gerçekleştirilebilir:

1. CEP arabirim kütüphanesini kullanma: CEP arabirim kütüphanesi, ana bilgisayar ortamı ile ilgili bilgi edinme amacıyla API'ler ve JSFL'leri çalıştırmanıza olanak tanıyan bir değerlendirme komut dosyası sağlar. CEP arabirim kütüphanesi hakkında daha fazla bilgi edinmek için, Eclipse içinde Yardım > Yardım İçerikleri > Adobe Extension Builder > Başvurular alanını açın.
2. JSFL kullanma: JSFL komut dosyaları, CEP arabirim kütüphanesinin Değerlendirme komut dosyası API'si kullanılarak çalıştırılabilir.
   
   JSFL'lerin dışında, Animate dahilindeki CEP altyapısı da yalnızca HTML panellerinde kullanılabilen şu olayları açığa çıkarır.
   • com.adobe.events.flash.documentChanged geçerli etkin belgede bir değişiklik olduğunda tetiklenir.
   • com.adobe.events.flash.timelineChanged geçerli etkin belgenin zaman çizelgesinde bir değişiklik yaptığınızda tetiklenir.
   • com.adobe.events.flash.documentSaved geçerli belgeyi kaydettiğinizde tetiklenir.
   • com.adobe.events.flash.documentOpened yeni bir belge açtığınızda tetiklenir.
   • com.adobe.events.flash.documentClosed geçerli etkin belgeyi kapattığınızda tetiklenir.
   • com.adobe.events.flash.documentNew yeni bir belge oluşturduğunuzda tetiklenir.
   • com.adobe.events.flash.layerChanged farklı bir katman seçtiğinizde tetiklenir.
   • com.adobe.events.flash.frameChanged farklı bir kare seçtiğinizde tetiklenir.
   • com.adobe.events.flash.selectionChanged sahne alanında farklı bir nesne seçtiğinizde tetiklenir.
   • com.adobe.events.flash.mouseMove farenizi Sahne Alanı üzerine getirdiğinizde tetiklenir.

Örnek

Yukarıdaki kod parçacığında:

• csinterface: CEP arabirim kütüphanesi nesnesi.
• com.adobe.events.flash.selectionChanged: Bir nesnenin seçiminde değişiklik tetikleyen olay. Yukarıda bahsedilen olaylardan herhangi birini de kullanabilirsiniz.
• CallbackFunction: Tetiklenen olayı dinleyen yöntem.