Kitaplıklar

Kitaplık, işlevleri diğer komut dosyalarında yeniden kullanılabilecek bir komut dosyası projesidir.

Uyarı: Kitaplık kullanan bir komut dosyası, tüm kod tek bir komut dosyası projesinde yer alıyormuş gibi o kadar hızlı çalışmaz. Kitaplıklar geliştirme ve bakımı daha kolay hale getirebilse de, hızın kritik önemde olduğu projelerde esnek şekilde kullanmak. İşte bu yüzden eklentilerde kitaplık kullanımı sınırlı olmalıdır.

Bir kitaplığa erişim elde etme

Projenize bir kitaplık eklemek için en az görüntüleme düzeyine sahip olmanız gerekir erişebilir. İstediğiniz kitaplığın yazarı değilseniz yazarla iletişim kurun ve erişim isteyin.

Dahil etmek istediğiniz kitaplığın komut dosyası kimliğine ihtiyacınız vardır. komut dosyası kimliğini Proje Ayarları bölümünde bulabilirsiniz sayfa.

Komut dosyası projenize kitaplık ekleyin

1. Apps Komut Dosyası düzenleyicisinin solunda, "Kitaplıklar"ın yanında Ekle'yi tıklayın. kitaplığı.
2. "Komut dosyası kimliği"nde alanına, kitaplığın komut dosyası kimliğini yapıştırın.
3. Ara'yı tıklayın.
   Bir hatayla karşılaşırsanız lütfen yapmaya çalıştığınız projeye en azından görüntüleme düzeyinde erişiminiz olmalıdır. dahil edin.
4. Sürüm açılır menüsünü tıklayıp kitaplık sürümünü seçin tıklayın.
5. Varsayılan "Tanımlayıcı"nın istediğiniz adı bu kitaplıkla kullanabilirsiniz. Bu, komut dosyanızın Google Ads'deki kitaplığına başvurur. Örneğin, bu değeri Test olarak ayarlarsanız söz konusu kitaplığın bir yöntemini şu şekilde çağırabilirsiniz: Test.libraryMethod().
   örneğin MailApp veya daha önce en son eklediğiniz kitaplık, ekleyebilirsiniz.
6. Ekle'yi tıklayın.

Kitaplık kullanma

Dahil edilen kitaplığınızı, varsayılan bir hizmet gibi kullanın. Örneğin, Örneğin, Test kitaplığınızın tanımlayıcısıysa Test hemen ardından bir nokta işaretiyle kitaplıktaki yöntemlerin listesini görüntüleyin.

Dahil edilen kitaplığa ait referans belgeleri aşağıdaki bağlantıdan açılabilir: şu adımları uygulayın:

Komut dosyası düzenleyicinin solunda, kitaplık adının yanındaki Diğer'i tıklayın. > Yeni sekmede açın.

Kitaplığı kaldırma

Komut dosyası düzenleyicinin sol tarafında, kitaplık adının yanındaki Diğer > Kaldır > Kitaplığı kaldır'ı tıklayın.

Bir kitaplık yazar tarafından silinirse kitaplık listesinden kaldırın.

Kitaplığı güncelleme

Kitaplığın sürümünü değiştirebilir veya tanımlayıcısını güncelleyebilirsiniz.

1. Editörün sol tarafındaki "Kütüphaneler"in altında kitaplığın adını tıklayın.
2. Değişiklikleri yapıp Kaydet'i tıklayın.

Kitaplık oluşturma ve paylaşma

Komut dosyası projenizi kitaplık olarak kullanmak ve paylaşmak için aşağıdaki adımları uygulayın.

1. Sürümü olan dağıtım oluşturma oluşturun.
2. En azından görüntüleme düzeyinde erişimi, kitaplığın tüm potansiyel kullanıcılarıyla paylaşın.
3. Bu kullanıcılara, Proje Ayarlar sayfası.

En iyi uygulamalar

Kitaplık yazarken uymanız gereken bazı kurallar şunlardır:

1. Projeniz için anlamlı bir ad seçin çünkü varsayılan tanımlayıcıdır.
2. Komut dosyanızdaki bir veya daha fazla yöntemin görünür olmasını istemiyorsanız (veya kullanılabilir) kullanıyorsanız, yöntemin adını alt çizgi. Örneğin, myPrivateMethod_().
3. Kitaplık kullanıcıları yalnızca numaralandırılabilir genel özellikleri görebilir. Buna, fonksiyon bildirimleri, var ile işlevin dışında oluşturulan değişkenler ve özellikler açıkça ayarlanmış çift tıklayın. Örneğin, enumerable öğesine sahip Object.defineProperty(), false olarak ayarlanmıştır , kitaplığınızda kullanabileceğiniz bir simge oluşturuyor, ancak kullanıcılarınız bu simgeye erişemiyor.

4. Kitaplığınızdaki kullanıcılarınızın, komut dosyası düzenleyicinin otomatik tamamlama ve dokümanları oluşturmak için JSDoc stilinde tüm işlevlerinizle ilgili dokümanlar da mevcuttur. Aşağıda bununla ilgili bir örnek verilmiştir:

   /**
    * Raises a number to the given power, and returns the result.
    *
    * @param {number} base the number we're raising to a power
    * @param {number} exp the exponent we're raising the base to
    * @return {number} the result of the exponential calculation
    */
   function power(base, exp) { ... }
   

Kaynak kapsamı

Kitaplıklarla çalışırken iki tür kaynak vardır: paylaşılan ve paylaşılmaz. Paylaşılan kaynak, hem kitaplığın hem de kapsayıcıdaki komut dosyasının aynı kaynak örneğine yerleşik erişimi vardır. İlgili içeriği oluşturmak için kullanılan aşağıdaki şemada paylaşılan kaynak örneği kullanılarak Kullanıcı Özellikleri:

Paylaşılmayan kaynak, hem kitaplığın hem de dahil olan komut dosyasının yerleşik erişimleri vardır. Ancak kütüphaneler sahip olduğu açık işlevler sayesinde, paylaşılmayan kaynaklara yardımcı olmaktır. Bu örnekte, komut dosyası özelliklerini görmek için kitaplığınızın her yerinden açın:

  function getLibraryProperty(key) {
    return ScriptProperties.getProperty(key);
  }

Aşağıdaki şemada, Komut Dosyası Özellikleri:

Referans olması amacıyla, paylaşılan ve paylaşılmayan kaynaklar aşağıdaki tabloda listelenmiştir:

Kaynak	Paylaşıldı*	Paylaşılmayan**	Notlar
Kilitle			Aynı örnek, emin olmanız gerekir.
Komut Dosyası Özellikleri			Aynı örnek, emin olmanız gerekir.
Önbellek			Aynı örnek, emin olmanız gerekir.
Tetikleyiciler			Kitaplıkta oluşturulan basit tetikleyiciler aşağıdakiler tarafından tetiklenmez: komut dosyası.
ScriptApp
UiApp
Kullanıcı Özellikleri
Günlük kaydedici ve yürütme dökümü
Sites, E-Tablolar ve diğer kapsayıcılar			getActive() için yapılan bir çağrı, bazı bilgiler var.
MailApp ve GmailApp
* Bu, kitaplığın kendisine ait bir özelliği/kaynak olduğunu tespit edip komut dosyası tarafından oluşturulan bir şeydir. ** Bu, kitaplığın kendi kaynak/özellik örneğinin olduğu anlamına gelir. ve kitaplığı kullanan tüm komut dosyalarının bu komut dosyalarına erişmesini anlamına gelir.

Kitaplığı test etme

Kitaplığınızı test etmek için başlık dağıtımını kullanın. Düzenleyici düzeyinde sahip olan herkes komut dosyasına erişmek için "head" dağıtımını kullanabilirsiniz.

Yine de kitaplığın en az bir sürümüne ihtiyacınız var kaydedildi.

Kitaplıkta hata ayıklama

Hata ayıklayıcıyı, mevcut kitaplığınız olan bir projede kullandığınızda dahil edilen kitaplığın bir işlevine geçebilir. Bu kod, hata ayıklayıcıyı salt görüntüleme modunda ve doğru sürümde çalıştırmalıdır.