Бібліотека компонентів
В оглядовій статті про створення компонентів ви познайомитеся з компонентами в програмі canvas. При створенні компонентів всередині програми ви можете також створити бібліотеку компонентів, які можна буде використовувати повторно. Створивши бібліотеку компонентів, розробники програм отримують можливість легко обмінюватися компонентами та оновлювати один або кілька компонентів спільно з іншими розробниками.
Бібліотеки компонентів — це контейнери визначень компонентів, які надають перелічені нижче можливості.
- Виявлення та пошук компонентів.
- Публікація оновлень.
- Сповіщення розробників про наявність оновлень компонентів.
Нотатка
Бібліотеки компонентів — це спосіб, який ми рекомендуємо для повторного використання компонентів у різних програмах. При використанні бібліотеки компонентів програма коректно підтримує залежності від використовуваних компонентів. Розробник програми отримає сповіщення про доступні оновлення залежних компонентів. Таким чином, усі нові повторно використовувані компоненти потрібно створювати всередині бібліотек компонентів. Попередню Power Apps функцію, яка дозволяла імпортувати компоненти з однієї програми полотна до іншої , припинено.
Різниця між програмою та бібліотекою компонентів
Бібліотека компонентів надає централізоване та кероване сховище компонентів для повторного використання.
Панель «Вставлення » на панелі навігації ліворуч за замовчуванням є вкладкою компонентів, якщо ви створюєте бібліотеку компонентів. При створенні програми у цьому поданні відображаються екрани, а не компоненти.
Екрани в бібліотеці компонентів доступні лише для тестування. Це надає розробникам бібліотеки можливість швидко тестувати створені компоненти на фактичному екрані, а також перевірити поведінку оновлення, оскільки компоненти з часом удосконалюються. Щоб скористатися компонентами з бібліотеки компонентів, необхідно створити програму, яка використовує цю бібліотеку компонентів.
Ви можете переглядати компоненти бібліотеки за допомогою екранів у бібліотеці, використовуючи можливість відтворення. При виборі вкладки компонента параметр "відтворення" вимкнуто. Бібліотека компонентів не відображається при використанні мобільної версії Power Apps.
Нотатка
Бібліотека компонентів, описана в цій статті, відрізняється від платформи Power Apps Component Framework, яка дає змогу розробникам і настроювачам створювати компоненти коду для програм на основі моделі та компонованих програм. Щоб дізнатися більше, перейдіть до Power Apps огляду компонентних фреймворків.
Робота з бібліотекою компонентів
Можна створити нову бібліотеку компонентів або редагувати наявну бібліотеку компонентів, використовуючи спільний інтерфейс. Перейдіть до пункту Power Apps> Більше на панелі навігації ліворуч, виберіть > Виявити всі, виберіть> Бібліотеки компонентів у розділі Удосконалення програм. Ви також можете закріпити опцію Бібліотеки компонентів у своєму Power Apps інтерфейсі. Додаткова інформація: Навігація ліворуч у Power Apps
Створення прикладу бібліотеки компонентів
Кроки, необхідні для створення компонентів у бібліотеці компонентів, аналогічні крокам для створенням компонентів у програмі. Вам потрібно створити бібліотеку компонентів, а потім повторно використати кроки для створення компонентів на прикладі огляду компонентів. Потім за допомогою бібліотеки компонентів можна буде надавати компоненти для повторного використання у новій програмі.
Увійти до Power Apps.
На панелі навігації ліворуч виберіть Бібліотеки компонентів, а потім виберіть Нова бібліотека компонентів. Або виберіть Більше на навігаційній панелі > ліворуч, виберіть Виявити всі,> виберіть Бібліотеки компонентів у розділі Удосконалення програм.
Назвіть бібліотеку компонентів як компоненти меню; ви також можете вказати іншу назву на свій вибір.
Дотримуйтесь інструкцій, щоб створити компоненти з прикладу огляду компонентів. Не потрібно відкривати Power Apps Studio або створювати нову пусту програму, оскільки ви вже створили нову бібліотеку компонентів. Почніть з кроку 2.
Після виконання кроків зі створення компонентів дотримуйтесь наступного набору кроків, щоб також додати компоненти на екран , а також кроки для створення властивості виведення.
Після завершення створення та тестування компонентів збережіть бібліотеку компонентів, вибравши меню Файл і натиснувши Зберегти .
У вас також є можливість зберегти нотатку проверсію. Примітка про версію виявляється корисною, коли треба дізнатися версію бібліотеки компонентів і при оновлення компонентів з цієї бібліотеки компонентів, що використовуються в програмах.
Порада
Примітка про версію допомагає при перевірці версій компонентів, а також нею користуються розробники програм, що використовують бібліотеку компонентів, під час перегляду змін і, за потреби, оновленні програм, які споживають ці компоненти. Перейдіть до оновлення бібліотеки компонентів, щоб дізнатися більше.
Збережену бібліотеку компонентів можна опублікувати. Для програм, які споживають матеріали з бібліотеки компонентів, доступні тільки опубліковані оновлення бібліотеки компонентів. Виберіть Опублікувати , щоб опублікувати версію бібліотеки компонентів:
Настроювання бібліотеки компонентів
Створюючи компонент у бібліотеці компонентів, можна дозволити настроювати компоненти в програмах, які використовують компоненти бібліотеки. За замовчуванням цей параметр увімкнено . Вимкніть цей параметр , щоб видалити можливість налаштовувати компонент під час використання в інших програмах.
У разі додавання компонента, який дозволяє настроювання, з’являться параметри, за допомогою яких можна редагувати цей компонент, щоб додаткового його настроїти. Програма створює локальну копію, і можна вносити зміни в локальну копію компонентів. Після редагування компонента зв’язок із бібліотекою компонентів буде видалено.
Якщо вибрати пункт Редагувати компонент , вам буде запропоновано скопіювати компонент локально для налаштування.
Проте, якщо не можна настроювати компоненти, у програмах, які їх використовують, не відображатиметься параметр для редагування компонента.
У цьому разі єдиним способом редагування компонента є редагування бібліотеки компонентів, в якій зберігається компонент.
Імпорт з бібліотеки компонентів
Після створення бібліотеки компонентів і її публікації програми можуть споживати компоненти з цієї бібліотеки компонентів шляхом імпортування бібліотеки. Ви також можете надати спільний доступ до бібліотеки компонентів.
Щоб імпортувати дані з бібліотеки компонентів, відредагуйте наявну програму або створіть нову. Після того, як програма відкриється в canvas app studio, виберіть «Вставити » або навігацію + ліворуч. Потім виберіть Отримати більше компонентів , щоб переглянути список бібліотек компонентів, доступних у поточному середовищі:
Ви побачите список бібліотек компонентів, доступних в поточному середовищі, в правій частині екрана. Виберіть окремий компонент з бібліотеки компонентів. Або скористайтеся командою «Вибрати все», щоб імпортувати всі компоненти з бібліотеки одразу:
Нотатка
Якщо розробник не бачить бібліотеку компонентів у списку для імпорту, переконайтеся, що цьому розробнику надано спільний доступ до бібліотеки компонентів. Щоб дізнатися більше, перейдіть добібліотека компонентів дозволів.
Зверніть увагу, що можна вибрати та імпортувати одразу кілька компонентів, а також компоненти з різних бібліотек компонентів.
Компоненти, доступні в програмі, перелічено в категорії «Настроювані» у списку компонентів на панелі «Вставлення ». Компоненти, доступні з імпортованих бібліотек компонентів, перелічено в категорії Компоненти бібліотеки:
Оновлення бібліотеки компонентів
Ви можете змінити наявну бібліотеку компонентів і зберегти будь-які зміни, вказавши інші примітки про версію. Однак оновлена версія бібліотеки компонентів має бути опублікована, перш ніж оновленнями можна буде користуватися в наявних програмах, в яких використовується ця бібліотека компонентів. У наведеному вище прикладі бібліотеки компонентів описано, як опублікувати бібліотеку компонентів після її збереження.
Програми, що використовують компоненти з бібліотеки можуть отримати найновіші зміни двома способами.
Метод 1. Сповіщення про оновлення компонентів під час редагування програми
Розробники інших програм отримують сповіщення про наявність оновлених компонентів. Сповіщення відображається, коли виробник редагує програму в студії для компонованих програм. Виробник може вирішити, чи оновлювати компоненти.
Виберіть Переглянути, і ви побачите опцію оновлення компонента:
Зверніть увагу на те, що тут відображається примітка про версію, яка додається при публікації версії бібліотеки компонентів.
Виберіть Оновити , щоб оновити компоненти.
Метод 2. Проактивна перевірка оновлень
Цей метод полягає в проактивній перевірці наявності оновлення програми під час роботи з програмою в Studio.
Щоб виконати цей пункт, виберіть пункт Вставити панель компонентів у лівій частині, а потім виберіть ... (три крапки) поруч із кнопкою пошуку. А потім виберіть Перевірити наявність оновлень.
Якщо для компонентів, які використовуються з бібліотеки, є оновлення, розробник отримає повідомлення про огляд і отримання найновіших змін. Після огляду та оновлення програма оновиться з найновішими компонентами.
Нижче показано процес отримання найновіших компонентів.
Оновлення компонента з бібліотеки компонентів у програмі, яка його використовує
Якщо імпортувати компонент з бібліотеки компонентів, ви не зможете редагувати його у програмі, що його використовує. Якщо ви виберете Редагувати компонент, ви побачите опцію створення копії компонента в поточній програмі, щоб ви могли внести зміни:
Якщо ви виберете Створити копію, компонент буде скопійовано до локального застосунку. Локальна копія компонента відображається в категорії «Нетипова» на панелі «Вставка ». Ця локальна копія компонента не отримуватиме оновлень, якщо пізніше буде опубліковано нову версію вихідної бібліотеки компонентів.
Нотатка
Створення локальної копії компонента не вплине на використовувані екземпляри компонентів із бібліотеки компонентів, і вони залишаться пов’язаними з визначенням бібліотеки компонентів. Лише екземпляри локально скопійованих компонентів (з категорії Custom) вважаються локальними компонентами програми.
Видалення бібліотеки компонентів
Якщо компонована програма посилається на бібліотеку компонентів, цю бібліотеку не можна видалити. Це стосується як середовищ Power Platform, так і середовищ, інших ніж Power Platform. Перш ніж видаляти бібліотеку, видаліть компонент із програми. Відомості про програми. які використовують бібліотеку компонентів, можна знайти або в поданні залежностей рішень, або в повідомленні, що відображається під час спроби видалення бібліотеки.
Дозволи бібліотеки компонентів
Надання спільного доступу до бібліотеки компонентів працює так само, як і для компонованих програм. Коли ви надаєте спільний доступ до бібліотеки компонентів, ви дозволяєте іншим повторно використовувати бібліотеку компонентів. Після отримання спільного доступу інші особи зможуть редагувати бібліотеку компонентів та імпортувати компоненти з цієї спільної бібліотеки, щоб створювати та редагувати програми. Якщо надати бібліотеку для спільного використання як співвласник, користувач зможе використовувати й редагувати бібліотеку компонентів, а також надавати до неї доступ, але не зможе видалити її або змінити для неї відповідальну особу.
Нижче наведено додаткові рекомендації щодо надання спільного доступу до бібліотек компонентів групам безпеки.
- Інтерфейс користувача спільного доступу не можна використовувати під час надання спільного доступу до бібліотек компонентів, створених у складі рішення. Натомість використовуйте командлет Set-PowerAppRoleAssignment із рівнем дозволів CanEdit , щоб надати спільний доступ до бібліотек компонентів вибраній групі безпеки.
- Бібліотеки компонентів, створені в Power Platform середовищі без Dataverse бази даних , до якої надано спільний доступ як співвласник , автоматично надають дозвіл CanEdit вибраній групі безпеки.
Відомі обмеження
Відомі обмеження, що застосовуються до компонентів, також стосуються бібліотек компонентів.
Не можна імпортувати компоненти з локально збереженої бібліотеки компонентів. Можна зберегти бібліотеку компонентів за допомогою функції «Зберегти>файл як>цей комп’ютер». Але за спроби імпорту такої збереженої бібліотеки компонентів з’явиться повідомлення про помилку:
Якщо програма й бібліотека компонентів імпортуються в середовище вперше, переконайтеся, що в програмі використовується найновіша версія компонента, включена в бібліотеку компонентів. В іншому разі програма не отримає оновлень після імпорту. Програма визнає оновлену версію й запропонує її під час наступного імпорту бібліотеки компонентів у те саме середовище.
Компоненти коду не підтримуються в бібліотеках компонентів.