Premiere Pro için indirdiğin bir eklenti .zxp uzantılı bir dosya olarak geliyorsa ve nasıl kuracağını bilmiyorsan yalnız değilsin. Adobe'nin eklenti kurulum süreci, uygulama içi bir mağazadan kurulum kadar basit değil — özellikle eklenti Adobe Exchange üzerinden değil de doğrudan geliştiriciden dağıtılıyorsa birkaç ekstra adım gerekiyor. Bu yazıda ZXP'nin ne olduğunu, kurulum yöntemlerini ve kurulum sonrası karşılaşabileceğin sorunları adım adım anlatıyoruz.
ZXP dosyası ve CEP eklentisi nedir
ZXP, Adobe'nin CEP (Common Extensibility Platform) altyapısını kullanan eklentiler için paketleme formatı. Kabaca bir ZIP dosyası gibi düşünebilirsin — içinde eklentinin arayüzünü oluşturan HTML/CSS/JavaScript dosyaları, Premiere ile konuşan ExtendScript veya UXP tarafı kodlar ve bir manifest dosyası bulunur.
CEP paneli dediğimiz şey, Premiere Pro'nun kendi penceresi içinde açılan, Window > Extensions menüsünden erişilen bir arayüz. Ayrı bir uygulama açmıyorsun; panel Premiere'in içinde bir sekme veya yüzen pencere olarak çalışıyor. Bu yüzden kurulum da normal bir .app ya da .exe kurulumundan farklı — dosyanın Premiere'in tanıdığı belirli bir klasöre yerleşmesi gerekiyor.
Kurulum yöntemleri
Yöntem 1: ZXP kurulum aracı kullanmak
En pratik yol, ZXP dosyalarını kurmak için tasarlanmış üçüncü parti araçlardan birini kullanmak. Bu tür araçlar dosyayı seçmeni istiyor, arşivi açıp doğru klasöre kopyalıyor ve gerekirse imza doğrulamasını atlamana yardımcı oluyor. Geliştiriciler genellikle eklenti ile birlikte hangi aracı önerdiklerini de belirtir; kurulum talimatlarını buna göre takip etmek en güvenli yol.
Yöntem 2: Manuel kurulum (extensions klasörüne kopyalama)
ZXP dosyası aslında bir arşiv olduğu için, dosya uzantısını .zip olarak değiştirip normal bir arşiv aracıyla açabilirsin. İçinden çıkan klasörü, işletim sistemine göre CEP eklentilerinin bulunduğu dizine kopyalaman gerekiyor.
Bu klasörün tam yolu Adobe'nin CEP sürümüne ve işletim sistemi ayarlarına göre değişebilir; genel olarak kullanıcı profili altında gizli bir Adobe/CEP dizini içinde yer alıyor. Gizli klasörleri görünür yapman gerekebilir (macOS'ta Cmd+Shift+., Windows'ta Gizli Öğeler seçeneği). Eklentinin geliştirici dokümantasyonunda genelde tam yol paylaşılır — orada verilen yolu esas al, çünkü sürüme göre küçük farklılıklar olabiliyor.
Manuel kurulumda dikkat etmen gereken nokta: kopyaladığın klasörün adı, eklentinin manifest dosyasındaki eklenti kimliğiyle uyumlu olmalı ve klasör yapısı bozulmadan (index.html, CSSXS manifest vb. dosyalar klasörün doğru seviyesinde) taşınmalı.
İmzasız eklenti ve PlayerDebugMode
Adobe, güvenlik nedeniyle varsayılan olarak yalnızca dijital sertifikayla imzalanmış ZXP dosyalarının yüklenmesine izin verir. Eğer kurmaya çalıştığın eklenti imzasızsa veya kendi imzasıyla (self-signed) paketlenmişse, Premiere paneli tanımayabilir ya da hiç listelemeyebilir.
Bu durumu aşmak için CEP eklentilerinde geliştiricilerin sıkça bahsettiği bir ayar var: sistemdeki bir konfigürasyon anahtarını değiştirerek imzasız eklentilere izin vermek. Bu ayarın tam adı ve nasıl değiştirileceği CEP sürümüne göre farklılık gösterebiliyor, bu yüzden burada net bir adım listesi vermek yerine şunu söylemek daha doğru: eklentini aldığın geliştiricinin resmi kurulum talimatına bak, çoğu zaman bu ayarı nasıl açacağını orada adım adım anlatıyorlar. Yanlış bir sistem ayarı değişikliği eklentinin çalışmasını değil, güvenlik davranışını etkiler — bu yüzden emin olmadığın bir değişikliği rastgele yapmak yerine kaynağı doğrulanmış talimatı takip etmek en sağlıklısı.
Eğer eklenti Adobe imzalı, dağıtıma hazır bir ZXP paketi olarak geliyorsa (yani geliştirici bunu resmi bir sertifikayla imzalamışsa) bu adımla hiç uğraşmana gerek kalmaz — panel doğrudan tanınır.
Panel görünmüyor, Extensions menüsü gri veya tıklanmıyor
Bu, kurulum sonrası en sık karşılaşılan durum ve genelde bir arıza değil. Window > Extensions menüsü, altında listelenecek bir panel yoksa boş ya da tıklanamaz görünür. Yani menünün açılmaması çoğu zaman menünün değil, eklentinin sorunudur.
Sırayla şunları kontrol et.
1. Menü adı değişmiş olabilir. Adobe yeni eklenti altyapısına (UXP) geçtiğinden beri, CEP panelleri bazı Premiere sürümlerinde ayrı bir menü altında listeleniyor — Window > Extensions (Legacy) gibi. Window menüsünü açıp "Extensions" geçen bütün satırlara bak; aradığın panel eskisinden farklı bir yerde duruyor olabilir. Ayrıca Window > Plugins ya da benzeri yeni bir menü varsa oraya da göz at.
2. Premiere'i tamamen kapatıp açtın mı? CEP panelleri yalnızca uygulama açılışında taranır. Premiere açıkken kopyalanan bir eklenti o oturumda listeye girmez. Kapatmak derken pencereyi kapatmak değil, uygulamadan tamamen çıkmak kastediliyor — macOS'ta Cmd+Q, Windows'ta görev yöneticisinden arka planda kalmadığını doğrulamak iyi olur.
3. Eklenti gerçekten doğru klasörde mi? İki ayrı CEP klasörü var: yalnızca senin kullanıcı hesabın için olan ve bütün kullanıcılar için ortak olan. Kurulum aracı birine yazmış, sen diğerine bakıyor olabilirsin. İkisini de kontrol et.
4. CEP klasörü hiç yok olabilir. Temiz bir Premiere kurulumunda, henüz hiç eklenti kurulmadıysa bu klasör oluşmamış olabilir. Manuel kurulum yapıyorsan klasörü kendin oluşturman gerekir; adının ve yolunun birebir doğru olması şart, aksi halde Premiere oraya bakmaz.
5. İmzasız eklenti izni kapalı olabilir. Bu durumda eklenti klasörde durur, Premiere onu görür, ama imza doğrulaması geçmediği için listeye hiç eklemez. Dışarıdan bakınca "menü boş" gibi görünür. Bir önceki bölümde anlattığımız ayar tam olarak bu durumu çözüyor.
6. Klasör yapısı bozulmuş olabilir. Arşivden çıkarırken fazladan bir üst klasör oluştuysa, manifest dosyası Premiere'in beklediği seviyede olmaz ve eklenti taranmaz. Klasörün içine girdiğinde doğrudan CSXS klasörünü ve index.html benzeri dosyaları görüyor olman lazım; önce başka bir klasör görüyorsan bir seviye fazla var demektir.
7. Premiere sürümü eklentiyle uyumlu mu? Eklentiler belirli bir sürüm aralığı hedefler. Çok eski bir Premiere'de yeni bir eklenti, çok yeni bir Premiere'de bakımsız bir eklenti tanınmayabilir. Eklentinin gereksinimlerini kontrol et.
8. Güvenlik yazılımı karantinaya almış olabilir. Özellikle Windows'ta bazı antivirüs programları tanımadığı JavaScript dosyalarını sessizce siliyor ya da erişimi engelliyor. Kurulumdan sonra klasöre girip dosyaların hâlâ orada olduğunu gözle doğrula.
Bu sekiz maddeyi sırayla geçtiğinde sorunun büyük kısmı çözülür. Çözülmezse, eklentiyi tamamen silip temiz bir kurulum yapmak en hızlı yol — yarım kalmış bir kurulumu tamir etmeye çalışmak genelde daha uzun sürüyor.
Sık karşılaşılan hatalar
Panel açılıyor ama beyaz/boş ekran geliyor: Bu genelde eklentinin kendi içindeki bir yükleme hatasından kaynaklanır, klasör yapısının bozulmuş olması sık görülen bir sebep. Eklentiyi silip temiz bir şekilde yeniden kurmak çoğu zaman çözer.
"Bu uzantı yüklenemedi" tarzı bir uyarı çıkıyor: Genelde imza doğrulaması ile ilgilidir; imzasız eklenti izninin açık olup olmadığını kontrol et.
Kurulum aracı dosyayı tanımıyor: ZXP dosyasının indirme sırasında bozulmadığından emin ol, gerekirse tekrar indir.
Son söz
ZXP kurulumu ilk bakışta karmaşık görünse de aslında birkaç sabit adımdan oluşuyor: dosyayı doğru klasöre yerleştirmek, gerekiyorsa imza iznini ayarlamak ve Premiere'i yeniden başlatmak. Kurulumla ilgili sorun yaşarsan önce eklentinin resmi kurulum talimatına dönmek, sonra da yukarıdaki kontrol listesini sırayla gözden geçirmek çoğu durumda sorunu çözüyor. Biz de korect Premiere Pro panelini geliştirirken bu kurulum sürecinin editörler için ne kadar kafa karıştırıcı olabildiğini gördük; bu yüzden kendi ZXP paketimizi macOS ve Windows için imzalı olarak hazırlıyoruz ki kurulum adımı mümkün olduğunca sorunsuz geçsin.