Библиотека с компоненти
В статията преглед за създаване на компоненти вие се запознавате с компоненти в приложението за платно. Докато създавате компоненти вътре в приложение, можете също да създадете библиотека от компоненти, които могат да бъдат използвани повторно. Създавайки библиотека на компоненти, производителите на приложения лесно споделят и актуализират един или повече компоненти с други производители.
Библиотеките на компонентите са контейнери с дефиниции на компоненти, които улесняват:
- Открийте и потърсете компоненти.
- Публикуване на актуализации.
- Уведомете производителите на приложения за наличните актуализации на компонентите.
Бележка
Библиотеките на компонентите са препоръчителният начин за повторно използване на компоненти в приложенията. Когато използвате библиотека на компоненти, приложение поддържа зависимости от компонентите, които използва. Производителят на приложения ще бъде известяван, когато актуализациите на зависимите компоненти станат достъпни. Следователно, всички нови компоненти за многократна употреба трябва да бъдат създадени в рамките на библиотеките на компонентите. По-ранната функция на Power Apps, която позволява импортиране на компоненти от едно приложение за платно в друго е оттеглена.
Разлика между приложение и библиотека за компоненти
Библиотеката за компоненти осигурява централизирано и управлявано хранилище на компоненти за повторно използване.
Екранът Вмъкване отляво по подразбиране на навигацията към раздела с компоненти, ако създадете библиотека на компоненти. Когато създавате приложение, този изглед показва екрани вместо компоненти.
Екраните вътре в библиотеката на компонентите са достъпни само за тестване. Той предоставя на създателите на библиотеката начин за бързо тестване на създадените компоненти на действителен екран, а също и за валидиране на поведението на актуализацията, тъй като компонентите се подобряват във времето. За да използвате компонентите от библиотеката на компоненти, трябва да създадете приложение, което използва библиотеката на компоненти.
Можете да визуализирате компоненти на библиотеката с помощта на екраните вътре в библиотеката с опцията за възпроизвеждане. Когато изберете раздела за компонент, опцията за възпроизвеждане е забранена. Библиотеката на компонентите не се показва при използване на Power Apps Mobile.
Бележка
Библиотеката на компонентите, разгледана в тази статия, е различна от тази на Power Apps component framework, която позволява на разработчиците и производителите да създават кодови компоненти за приложения, управлявани от модели, и за платна. За повече информация отидете на преглед на Power Apps component framework.
Работа с библиотека за компоненти
Можете да създадете нова библиотека на компоненти или да редактирате съществуваща библиотека на компоненти от същия интерфейс. Отидете на Power Apps > изберете Още от лявата навигация > изберете Открийте всички > изберете Библиотеки с компоненти от секцията Подобрения на приложенията. Можете също така да закачите опцията за библиотеки с компоненти към вашия Power Apps интерфейс. Повече информация: Лява навигация в Power Apps
Създайте примерна библиотека на компоненти
Стъпките за създаване на компоненти в библиотеката на компоненти са същите като създаването на компоненти вътре в приложение. Ще създадете библиотека на компоненти и след това ще използвате повторно стъпките за създаване на компоненти от Пример за преглед на компоненти. След това ще използвате библиотеката на компонентите, за да осигурите компоненти за многократна употреба в ново приложение.
Влезте в Power Apps.
Изберете Библиотеки с компоненти в лявата навигация и след това изберете Нова библиотека с компоненти. Друга възможност е да изберете Още от навигацията вляво > да изберете Открий всички > изберете Библиотеки с компоненти от секцията Подобрения на приложенията.
Дайте име на компонентната библиотека като Компоненти на менюто; можете също да посочите друго име по ваш избор.
Следвайте стъпките за създаване на компоненти от Пример за преглед на компоненти. Не е нужно да отваряте Power Apps Studio или да създавате ново празно приложение, тъй като вече сте създали нова компонентна библиотека. Започнете със стъпка 2.
Следвайки стъпките за създаване на компоненти, следвайте и следващия набор от стъпки добавете компоненти към екран и стъпките към създаване на изходно свойство.
След като завършите създаването и тестването на компонентите, запишете библиотеката на компонентите, като изберете менюто досие и след това изберете Записване.
Имате и опция за записване на бележка за версия. Бележка за версия е полезна за извличане на версии на библиотека на компоненти и за надграждане на компонентите, използвани в приложения от тази библиотека на компоненти.
Съвет
Бележка за версия е полезна при преглед на версии на библиотека на компоненти и за производителите на приложения, които използват вашата библиотека на компоненти, да преглеждат промените и да актуализират приложения, консумиращи тези компоненти, ако е необходимо. Отидете на актуализирайте библиотека на компонентите за повече информация.
Запазената библиотека на компонентите може да бъде публикувана. Само публикуваните актуализации на библиотеката на компоненти са достъпни за приложения, които консумират библиотека на компоненти. Изберете публикуване, за да публикувате версията на компонентната библиотека:
Персонализиране на компонента на библиотеката
Когато създавате компонент в библиотека с компоненти, имате опцията да разрешите компонентът да бъде персонализиран, когато се използва от приложения, които използват компонентите на библиотеката. Тази настройка е включена по подразбиране. Завъртете тази настройка на Изкл. за премахване на възможността за персонализиране на компонент, докато се използва в други приложения.
Когато добавите компонент, който позволява персонализиране, ще видите опция за редактиране на този компонент за повече персонализиране. Приложението прави локално копие и можете да правите промени в копието на локалния компонент. Връзката с библиотеката на компонентите се премахва, след като компонентът бъде редактиран.
Избиране Редактиране на компонент ви подканва да копирате компонента локално за персонализиране.
Въпреки това, когато не позволите компонентите да бъдат персонализирани, консумиращите приложения няма да показват опцията за редактиране на компонента.
В този случай единственият начин да редактирате компонента е да редактирате библиотеката с компоненти, където се съхранява компонентът.
Импортиране от библиотека на компоненти
След като създадете библиотека на компоненти и публикувате, приложенията могат да консумират компонентите от тази библиотека на компоненти, като импортират библиотеката. Можете също да споделите библиотека с компоненти.
За да импортирате от библиотека на компоненти, редактирайте съществуващо приложение или създайте ново приложение. След като приложението се отвори в студио за приложение за платно, изберете Вмъкване или + в лявата навигация. След това изберете Вземете още компоненти, за да изброите библиотеките на компонентите, налични в текущата среда:
Ще видите списъка на библиотеките на компоненти, налични в текущата среда в дясната част на екрана. Изберете отделен компонент от библиотека на компоненти. Или използвайте Избери всички, за да импортирате всички компоненти от библиотеката наведнъж:
Бележка
Ако производителят не вижда библиотеката на компонентите, посочена в секцията за импортиране, уверете се, че библиотеката на компонентите е споделена с производителя. За повече подробности отидете на разрешения за библиотека на компонентите.
Забележете, че можете да изберете и импортирате повече от един компонент и в различни библиотеки на компоненти.
Компонентите, налични вътре в приложението, са изброени под категорията Персонализирано в списъка на компонентите в панела Вмъкване. Компонентите, налични от импортираните библиотеки на компоненти, са изброени под категорията Компоненти на библиотеката:
Актуализиране на библиотека с компоненти
Можете да модифицирате съществуваща библиотека на компоненти и да запазите всички промени с други бележки за версията. Обновената версия на библиотеката на компонентите обаче трябва да бъде публикувана за използване в съществуващи приложения, които използват библиотеката на компоненти. Стъпките на примерната библиотека на компоненти по-горе обясняват как да публикувате компонентна библиотека, след като я запазите.
Има два начина, по които приложенията, използващи компонентите от библиотеката, могат да получат най-новите промени.
Метод 1: Известие за актуализация на компонента при редактиране на приложение
Производителите на други приложения се уведомяват за наличните актуализирани компоненти. Известието се появява, когато производителите редактират приложенията в студиото за приложение на платното. Те могат да изберат да актуализират компонентите:
Изберете Преглед и ще видите опцията за актуализиране на компонента:
Забележете, че бележката за версия, която сте добавили при публикуването на версията на компонентната библиотека, се показва тук.
Изберете Актуализиране, за да актуализирате компоненти.
Метод 2: Проактивна проверка за актуализации
Този метод е да проверявате за актуализация на приложението активно, докато работите върху приложението в Studio.
За да направите тази проверка, изберете Вмъкване на панел с компоненти вляво и след това изберете ... (многоточие) до бутона за търсене. След това изберете Проверка за актуализации.
Ако има актуализации в компонентите, използвани от библиотеката, производителят ще получи съобщението за преглед и ще получи най-новите промени. След преглед и актуализация приложението се актуализира с най-новите компоненти.
Следващата анимация показва процеса на получаване на най-новите компоненти.
Актуализиране на компонент от библиотека с компоненти в използващо приложение
Ако импортирате компонент от библиотека на компоненти, не можете да го редактирате в консумиращото приложение. Ако изберете Редактиране на компонент, ще видите опция за създаване на копие на компонента в текущото приложение, за да направите промени:
Ако изберете Създаване на копие, компонентът се копира в локалното приложение. Локалното копие на компонента се появява под категорията Персонализирано в екрана Вмъкване. Това локално копие на компонента няма да получава актуализации, ако по-късно бъде публикувана нова версия на първоначалната библиотека на компонентите.
Бележка
Използваните екземпляри на компоненти от библиотеката с компоненти няма да бъдат засегнати, след като създадете локално копие на компонент, и ще останат свързани с дефиницията на библиотеката с компоненти. Само екземпляри на локално копираните компоненти (от категория Персонализирани) се считат за локални компоненти на приложението.
Изтриване на библиотека с компоненти
Ако библиотека с компоненти е посочена от приложение за платно, тя не може да бъде изтрита. Това важи и за двете Power Platform и не-Power Platform среди. Премахнете компонента от приложението, преди да изтриете библиотеката. Можете да намерите информация за приложенията, използващи библиотеката с компоненти, в изгледа на зависимостите на решението или в съобщението, което се показва, когато се опитате да изтриете библиотека.
Разрешения на библиотека с компоненти
Споделянето на библиотека на компоненти работи по същия начин, по който споделяте приложение за платно. Когато споделяте библиотека на компоненти, позволявате на други да използват повторно библиотеката на компоненти. Веднъж споделени, други могат да редактират библиотеката на компоненти и да импортират компоненти от тази споделена библиотека на компоненти за създаване и редактиране на приложения. Ако е споделен като съсобственик, потребителят може да използва, редактира и споделя компонентна библиотека, но не и да изтрива или променя собственика.
Допълнителни съображения при споделяне на библиотеки с компоненти към групи за защита:
- Не можете да използвате потребителски интерфейс за споделяне когато споделяте библиотеки с компоненти, създадени като част от решение. Вместо това използвайте Кратка команда Set-PowerAppRoleAssignment с CanEdit ниво на разрешение за споделяне на библиотеките с компоненти с избраната група за защита.
- Библиотеки с компоненти, създадени в среда на Power Platform без Dataverse база данни споделено като Съсобственик автоматично предоставяне CanEdit разрешение за избраната група за сигурност.
Известни ограничения
Известни ограничения, приложими за компоненти също се прилага за библиотеки на компоненти.
Не можете да импортирате компоненти от локално запазена библиотека с компоненти. Възможно е да запазите библиотека с компоненти, като използвате Файл > Запази като > Този компютър. Но ако се опитате да импортирате такава запазена библиотека с компоненти, ще видите следното съобщение за грешка:
Ако импортирате приложение и библиотека с компоненти в среда за първи път, уверете се, че приложението използва най-новата версия на компонента, включен в библиотеката с компоненти. В противен случай приложението няма да получава актуализации след импортирането. Приложението ще разпознае и ще поиска актуализираната версия при последващо импортиране на библиотека с компоненти в същата среда.
Компонентите на кода не се поддържат в библиотеките с компоненти.
Вижте също
- Компоненти на платното
- Управление на жизнения цикъл на библиотека с компоненти (ALM)
- Карта на полетата за въвеждане на компонент
- Добавяне на мултимедия към компонент
- Формули за поведение на компоненти
- Power Apps component framework
- Добавяне на компоненти на платно към персонализирана страница за приложение, управлявано от модел
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).