Bileşen kitaplığı

Bileşen oluşturma hakkındaki genel bakış makalesinde, tuval uygulamasındaki bileşenler hakkında bilgi edinirsiniz. Bir uygulamanın içinde bileşenler oluştururken, yeniden kullanabileceğiniz bir bileşen kitaplığı da oluşturabilirsiniz. Uygulama oluşturucular, bileşen kitaplığı oluşturarak bir veya daha fazla bileşeni diğer oluşturucularla kolayca paylaşabilir ve güncelleştirebilir.

Bileşen kitaplıkları, şunları kolaylaştıran bileşen tanımı kapsayıcılarıdır:

• Bileşenleri keşfedin ve arayın.
• Güncelleştirmeleri yayımlayın.
• Uygulama geliştiricilerine kullanılabilir bileşen güncelleştirmelerini bildirin.

Not

Bileşen kitaplıkları, bileşenleri uygulamalar arasında yeniden kullanmanın önerilen yoludur. Uygulama, bileşen kitaplığı kullanırken kullandığı bileşenlere olan bağımlılıkları korur. Bağımlı bileşenlere yönelik güncelleştirmeler kullanılabilir olduğunda uygulama oluşturucu uyarılır. Bu nedenle, bileşen kitaplıkları içinde yeniden kullanılabilir bileşenler oluşturun. Bileşenlerin bir tuval uygulamasından diğerine aktarılmasını sağlayan eski bir Power Apps özelliği kullanımdan kaldırılmıştır.

Uygulama ve bileşen kitaplığı arasındaki fark

Bileşen kitaplığı, yeniden kullanılabilirlik için bileşenlerin merkezi ve yönetilen bir deposunu sağlar.

Bileşen kitaplığı oluşturursanız soldaki gezinme bölmesindeki Ekle bölmesi, varsayılan olarak bir bileşenler sekmesidir. Uygulama oluşturduğunuzda bu görünüm, bileşenler yerine ekranları gösterir.

Not

Bir bileşen kitaplığındaki ekranlar yalnızca test için kullanılabilir. Kitaplık oluşturucularına, oluşturulan bileşenleri gerçek bir ekranda hızlı bir şekilde test etmenin ve bileşenler zaman içinde geliştirildikçe güncelleştirme davranışını doğrulamanın bir yolunu sunar. Bileşen kitaplığındaki bileşenleri kullanmak için, bileşen kitaplığını kullanan bir uygulama oluşturmanız gerekir.

Yürütme seçeneğiyle kitaplığın içindeki ekranları kullanarak bileşen kitaplığı bileşenlerinin önizlemesini görüntüleyebilirsiniz. Bileşen sekmesini seçtiğinizde yürüt seçeneği devre dışı bırakılır. Power Apps Mobile kullanılırken bileşen kitaplığı görüntülenmez.

Not

Bu makalede açıklanan bileşen kitaplığı, geliştiricilerin ve oluşturucuların model temelli uygulamalar ve tuval uygulamaları için kod bileşenleri oluşturmalarını sağlayan Power Apps component framework'ten farklıdır. Daha fazla bilgi için bkz. Power Apps bileşen çerçevesine genel bakış.

Bileşen kitaplığıyla çalışma

Aynı arabirimden yeni bir bileşen kitaplığı oluşturabilir veya var olan bir bileşen kitaplığını düzenleyebilirsiniz. Power Apps'e gidin>, sol gezintiden Daha fazla'yı seçin>, Tümünü keşfet'i seçin>, Uygulama iyileştirmeleri bölümünden Bileşen kitaplıkları'nı seçin. Dilerseniz Bileşen kitaplıkları seçeneğini Power Apps arabiriminize sabitleyebilirsiniz. Daha fazla bilgi için bkz. Power Apps’te sol gezinti.

Örnek bileşen kitaplığı oluşturma

Bileşen kitaplığı içinde bileşen oluşturma adımları, bir uygulama içinde bileşen oluşturma ile aynıdır. Bileşen kitaplığı oluşturacak ve ardından bileşenlere genel bakış örneğinden bileşen oluşturma adımlarını yeniden kullanacaksınız. Ardından, yeni bir uygulamada yeniden kullanılabilir bileşenleri sağlamak için bileşen kitaplığını kullanırsınız.

1. Power Apps'te oturum açın.

2. Sol gezinti bölmesinden Bileşen kitaplıkları'nı seçin ve ardından Yeni bileşen kitaplığı'nı seçin. Alternatif olarak, sol gezinti bölmesinde Bileşen kitaplıkları'nı görmüyorsanız, sol gezinti bölmesinden Diğer'i seçin, Tümünü bul düğmesini ve Uygulama geliştirmeleri bölümünde Bileşen kitaplıkları'nı seçin.

3. Bileşen kitaplığını Menü bileşenleri olarak adlandırın; veya tercihinize göre farklı bir ad verin.

4. Bileşenlere genel bakış örneği'nden bileşenler oluşturmak için adımları izleyin. Yeni bir bileşen kitaplığı oluşturduğunuz için Power Apps Studio'yu açmanız veya yeni bir boş uygulama oluşturmanız gerekmez. 2. Adım ile başlayın.

   Bileşen oluşturma adımlarını izledikten sonra ekrana bileşenler ekleme ve çıkış özelliği oluşturma adımlarını izleyin.

5. Bileşenleri oluşturma ve test etme işlemlerini tamamladıktan sonra, uygulama eylemlerinden Kaydet simgesini seçerek bileşen kitaplığını kaydedin.

   Kaydet simgesinin yanındaki ok menüsünün altında sürüm notlarıyla kaydet seçeneğiniz de vardır. Sürüm notu, bileşen kitaplığının sürümlerini almak ve uygulamalarda kullanılan bileşenleri bu bileşen kitaplığından yükseltmek için kullanışlıdır. Uygulama eylemleri hakkında daha fazla ayrıntı için Power Apps Studio'yu anlama makalesine bakın.

   

   İpucu

   Sürüm notu, bileşen kitaplığının sürümlerini incelerken ve bileşen kitaplığınızı kullanan uygulama geliştiricileri için değişiklikleri incelemek ve gerektiğinde bu bileşenleri kullanan uygulamaları güncelleştirmek için yararlıdır. Daha fazla ayrıntı için bileşen kitaplığını güncelleştirme bölümüne gidin.

6. Kaydedilmiş bir bileşen kitaplığı yayımlayabilirsiniz. Bileşen kitaplığı kullanan uygulamalar için yalnızca yayımlanmış bileşen kitaplığı güncelleştirmeleri kullanılabilir. Bileşen kitaplığı sürümünü yayımlamak için uygulama eylemlerinden Yayımla simgesini seçin:

   

Kitaplık bileşen özelleştirmesi

Bileşen kitaplığı içinde bir bileşen oluşturduğunuzda, kitaplık bileşenlerini kullanan uygulamaların bileşeni özelleştirip özelleştiremeyeceğini ayarlayabilirsiniz. Varsayılan olarak, bu ayar bileşen özelliklerinde Açık'tır . Bileşeni diğer uygulamalarda özelleştirme özelliğini kaldırmak için bu ayarı Kapalı duruma getirin.

Özelleştirmeye izin veren bir bileşen eklediğinizde, daha fazla özelleştirme için bu bileşeni düzenleme seçeneği görürsünüz. Uygulama yerel bir kopya oluşturur ve yerel bileşen kopyasında değişiklik yapabilirsiniz. Bileşeni düzenledikten sonra bileşen kitaplığıyla ilişkilendirme kaldırılır.

Bileşeni düzenle'nin seçilmesi, bileşeni özelleştirme için yerel olarak kopyalamanıza yönelik istemde bulunur.

Bileşenlerin özelleştirilmesine izin vermezseniz, tüketen uygulamalar bileşeni düzenleme seçeneğini göstermez.

Bu durumda, bileşeni düzenlemek için tek yol, bileşenin depolandığı bileşen kitaplığını düzenlemedir.

Bileşen kitaplığından içeri aktarma

Bir bileşen kitaplığı oluşturup yayımladıktan sonra, uygulamalar kitaplığı içeri aktararak bu bileşen kitaplığındaki bileşenleri kullanabilir. Ayrıca bileşen kitaplığını paylaşabilirsiniz.

Bileşen kitaplığından içeri aktarmak için mevcut bir uygulamayı düzenleyin veya yeni bir uygulama oluşturun. Uygulama, tuval uygulama stüdyosunda açıldıktan sonra sol taraftaki gezinti bölmesinde Ekle'yi veya + simgesini seçin. Ardından, geçerli ortamda kullanılabilen bileşen kitaplıklarını listelemek için Daha fazla bileşen al'ı seçin:

Geçerli ortamda kullanılabilen bileşen kitaplıklarının listesini ekranın sağ tarafında görürsünüz. Bileşen kitaplığından tek bir bileşen seçin. Veya tüm bileşenleri bir kerede kitaplıktan içeri aktarmak için Tümünü seç'i kullanın:

Not

Geliştirici, alma bölümünde listelenen bileşen kitaplığını görmüyorsa bileşen kitaplığının geliştiriciyle paylaşıldığından emin olun. Diğer ayrıntılar için bkz. bileşen kitaplığı izinleri.

Not

Birden fazla bileşeni seçip farklı bileşen kitaplıkları arasında içeri aktarabilirsiniz.

Uygulamanın içinde bulunan bileşenler, Ekle bölmesindeki bileşenler listesinde Özel kategorisi altında listelenir. İçeri aktarılan bileşen kitaplıklarında bulunan bileşenler Kitaplık bileşenleri kategorisi altında listelenir:

Bileşen kitaplığını güncelleştirme

Var olan bir bileşen kitaplığını değiştirebilir ve değişiklikleri diğer sürüm notlarıyla kaydedebilirsiniz. Ancak güncelleştirilmiş bileşen kitaplığı sürümü, bileşen kitaplığını kullanan var olan uygulamalarda kullanılmak üzere yayımlanmalıdır. Örnek bileşen kitaplığı adımları, bir bileşen kitaplığını kaydettikten sonra yayımlamayı açıklar.

Uygulamaların kitaplıktan bileşenleri kullanarak en son değişiklikleri alabilmesinin iki yolu vardır.

Yöntem 1: Uygulama düzenlendiğinde bileşen güncelleştirme bildirimi

Güncelleştirilmiş bileşenler kullanılabilir olduğunda diğer uygulamaların oluşturucularına bildirim gönderilir. Geliştiriciler, tuval uygulama stüdyosundaki uygulamaları düzenlediğinde bildirim görüntülenir. Bileşenleri güncelleştirmeyi şu şekilde seçebilirler:

Gözden Geçir'i seçtiğinizde bileşeni güncelleştirme seçeneğini görürsünüz:

Bileşen kitaplığı sürümünü yayımlarken eklediğiniz sürüm notları burada görünür.

Bileşenleri güncelleştirmek için Güncelleştir'i seçin.

Yöntem 2: Güncelleştirmeler için proaktif denetim

Studio'da uygulama üzerinde çalışırken uygulama güncelleştirmesini proaktif olarak denetlemek için bu yöntemi kullanın.

Bu denetimi yapmak için sol taraftaki Bileşen ekle panelini seçin ve ardından Güncelleştirmeleri denetle simgesini seçin.

Kitaplıktan kullanılan bileşenler için güncelleştirmeler varsa, gözden geçirmek ve en son değişiklikleri almak için bir ileti alırsınız. Gözden geçirip güncelleştirdiğinizde uygulama en son bileşenlerle güncelleştirilir.

Bir bileşen kitaplığını kullanan uygulamada bir bileşeni güncelleme

Bileşeni, bileşen kitaplığından içeri aktarırsanız onu kullanan uygulamanın içinde bileşeni düzenleyemezsiniz. Bileşeni düzenle'yi seçerseniz, değişiklik yapabilmeniz için geçerli uygulamanın içinde bileşenin bir kopyasını oluşturma seçeneğini görürsünüz:

Kopya oluştur'u seçerseniz bileşen yerel uygulamaya kopyalanır. Bileşenin yerel kopyası Ekle bölmesindeki Özel kategorisi altında görünür. Bileşenin bu yerel kopyası, kaynak bileşen kitaplığının yeni bir sürümü daha sonra yayımlanırsa güncelleştirmeleri almaz.

Not

Bileşen kitaplığındaki bileşenlerin kullanımdaki örnekleri, bir bileşenin yerel kopyasını oluşturduktan ve bileşen kitaplığı tanımına bağlı kaldıktan sonra etkilenmez. Yalnızca yerel olarak kopyalanmış bileşenlerin örnekleri (Özel kategoriden) yerel uygulama bileşenleri olarak kabul edilir.

Bileşen kitaplığını silme

Bir bileşen kitaplığına bir tuval uygulaması tarafından referans veriliyorsa bu kitaplık silinemez. Bu koşul hem Power Platform hem de Power Platform dışı ortamlar için geçerlidir. Kitaplığı silmeden önce bileşeni uygulamadan kaldırın. Bileşen kitaplığını kullanarak uygulama hakkında bilgileri, çözüm bağımlılıkları görünümünde veya kitaplığı silmeye çalıştığınızda gösterilen iletide bulabilirsiniz.

Bileşen kitaplığı izinleri

Bileşen kitaplığını paylaşmak tuval uygulamasını paylaştığınız gibi çalışır. Bileşen kitaplığını paylaştığınızda başkalarının bileşen kitaplığını yeniden kullanmasına izin verirsiniz. Paylaşıldıktan sonra, diğerleri bileşen kitaplığını düzenleyebilir ve uygulama oluşturmak ve düzenlemek için bileşenleri bu paylaşılan bileşen kitaplığından içeri aktarabilir. İkincil sahip olarak paylaşılırsa kullanıcı; bir bileşen kitaplığını kullanabilir, düzenleyebilir ve paylaşabilir ancak sahibini silemez veya değiştiremez.

Bileşen kitaplıklarını güvenlik gruplarına paylaşırken dikkat edilecek diğer noktalar:

• Bir çözümün parçası olarak oluşturulan bileşen kitaplıklarını paylaşırken UI paylaşma kullanamazsınız. Bunun yerine CanEdit izin düzeyiyle seçilen güvenlik grubundaki bileşen kitaplıklarını paylaşmak için Set-PowerAppRoleAssignment cmdlet kullanın.
• Eş sahip olarak paylaşılan Dataverse veritabanı olmadan Power Platform ortamında oluşturulan bileşen kitaplıkları otomatik olarak seçilen güvenlik grubuna CanEdit iznini tanır.

Bilinen sınırlamalar

• Bileşenler için geçerli olan bilinen sınırlamalar, bileşen kitaplıkları için de geçerlidir.

• Yerel olarak kaydedilmiş bir bileşen kitaplığından bileşenleri içe aktaramazsınız. Uygulama eylemlerinden Bir kopyasını indir seçeneğini belirleyerek bir bileşen kitaplığını indirebilirsiniz. Ancak kaydedilen bileşen kitaplığını içeri aktarmaya çalışırsanız aşağıdaki hata iletisini görürsünüz:

  

• Bir ortamdaki uygulama ve bileşen kitaplığını ilk defa içe aktarıyorsanız uygulamanın bileşen kitaplığına dahil edilen bileşenin en son sürümünü kullandığından emin olun. Aksi takdirde uygulama, içeri aktarma işleminden sonra güncelleştirmeleri almaz. Uygulama, sonraki bileşen kitaplığı aynı ortama aktarıldıktan sonra güncelleştirilmiş sürümü tanır ve ister.

• Kod bileşenleri bileşen kitaplıklarının içinde desteklenmez.

Ayrıca bkz.

• Tuval bileşenleri
• Bileşen kitaplığı uygulaması yaşam döngüsü yönetimi (ALM)
• Bileşenin giriş alanlarını eşleme
• Bir bileşene multimedya ekleme
• Bileşenler için davranış formülleri
• Power Apps bileşen çerçevesi
• Model temelli bir uygulamada özel bir sayfaya tuval bileşenleri ekleme