Kütüphane Geliştiricileri için Bilgiler

Tutarlılık sorunlarından kaçınmak ve kullanıcıyı yeterince desteklemek için, kütüphanelerin oluşturulması, referans verilmesi, şifrelenmesi, korunması ve belgelendirilmesi için belirli kurallara uyduğunuzdan emin olun.

Aşağıdaki açıklama, kütüphane geliştirme olanaklarına yalnızca genel bir bakış sunmaktadır. Bu konuların daha ayrıntılı bir açıklaması için kütüphane geliştirmeye yönelik "LibDevSummary" kılavuzuna bakın.

Daha fazla bilgi için bkz: ⮫ «Kütüphaneleri Kullanma », ⮫ «Kütüphane Deposu », ⮫ «Kütüphane Yönetici »

Genel

Kütüphaneler için kategoriler tanımlayabilirsiniz. Kütüphaneler daha sonra kütüphane havuzunda bu kategorilerin altında görüntülenir.
Entegre nesnelere kesin erişim sağlamak için bir kütüphane için bir ad alanı tanımlayabilirsiniz. POU adının önüne isim alanının eklenmesiyle erişim açık hale gelir:

<namespace>.<değişken adı>

Örnek: ‎AC.Module‎
Şifrelenmemiş kütüphanelerin POU'larını (‎*.library‎) Kütüphane Yöneticisinde ilgili girdiye çift tıklayarak açabilirsiniz.
Aşağıdaki kitaplık türlerini oluşturabilirsiniz:
- ‎*.library‎: Uygulama kütüphanesi (kütüphanenin kaynak kodu)
- *‎.compiled-library‎, ‎*.compiled-library-v3‎: Korumalı kütüphane
  
  Kaynak koduna artık erişilemiyor.
- ‎*_Itfs.library‎: Arayüz kütüphanesi
  
  Yalnızca bir bileşenin arayüz tanımı için kullanılan nesneleri (örneğin, sabitler, yapılar veya arayüzler) içerir ve herhangi bir kod oluşturmaz
- ‎*_Cnt.library‎: Konteyner kütüphanesi
  
  POU'ları içermez, yalnızca diğer kütüphaneleri içerir
  
  Bu nedenle, POU'ları konteyner kütüphanesinin en üst seviyesinde yayınlanan bir dizi kütüphaneyi uygun bir şekilde entegre etmek için kullanılır
Harici kütüphaneleri uygulamaya entegre edebilirsiniz. Harici kütüphaneler CODESYS dışında farklı bir programlama dilinde programlanır (örn: C).

Kütüphanelerin korunması

Kaynak kodu koruması

Bir kütüphane "derlenmiş-kütüphane" formatında hazırlandığında, kütüphane bir projeye entegre edildikten sonra kütüphane POU'larının kaynak kodu artık görünmez.
İmzalama

CODESYS V3 SP15 ve üzeri sürümlerde, kütüphane projelerinin imzalanması için her zaman bir sertifika kullanılır (‎*.compiled-library-v3‎). İmzalama, güvenlik ekranındaki bir ayar aracılığıyla uygulanabilir. Daha sonra derlenmiş bir kütüphane oluşturmak için kullanıcı profilinizde kod imzalamaya uygun bir sertifikaya ihtiyacınız vardır.

CODESYS < V3 SP15 (‎*.compiled-library‎) ile uyumlu olması gereken kütüphane projeleri için, özel bir anahtar ve ilgili bir belirteç ile yalnızca daha az güvenli imzalama mümkündür. Kullanımdan kaldırılan bu yöntemler yalnızca uyumluluk nedeniyle kullanılmalıdır. Ayarlar «Proje Bilgileri» içinde «İmzalama» sekmesinde yapılandırılır.

Not: Kütüphaneleri imzalamak için, daha iyi bir depolama biçimi kullanıldığından derleyici sürümü 3.5.15.0 veya üstünü kullanmalısınız.
Lisanslama

Kütüphaneleri bir lisans (dongle veya soft container) aracılığıyla koruyabilirsiniz. Lisans korumalı kütüphaneler kütüphane deposuna yüklenebilir. Ancak, projede kullanım için geçerli lisansın bilgisayarda bulunması gerekir. Lisanslar Lisans Yöneticisi'nde yönetilir.

Kütüphane versiyonları

Sistemde aynı anda birden fazla kütüphane sürümü yüklü olabilir.
Bir kütüphanenin birden fazla versiyonunu aynı anda projenize entegre edebilirsiniz. Ancak, bunu yapmanızı tavsiye etmiyoruz. Bu durumda, kütüphanelerinin her birine benzersiz bir isim alanı atanmalı ve sembollerine erişim nitelikli olmalıdır.

Örnekler: ‎V1.SendBlob‎,‎V2.SendBlob‎

Başvurulan kütüphaneler

Bir kütüphaneyi diğer kütüphanelere entegre edebilirsiniz (referanslı kütüphaneler). İç içe geçme herhangi bir derinlikte olabilir.
Referans verilen kütüphanelerin Kütüphane Yöneticisi'nde görünür olup olmayacağını tanımlayabilirsiniz.
Referans verilen kütüphaneleri kütüphane yer tutucuları aracılığıyla entegre edebilirsiniz. Bu şekilde, sürüm bağımlılıkları veya satıcıya özgü kütüphaneleri kullanma zorunluluğu nedeniyle oluşabilecek sorunlardan kaçınırsınız.