Biblioteka składników

W ogólnym artykule dotyczącym tworzenia składników opisano składniki w aplikacji kanwy. Podczas tworzenia składników wewnątrz aplikacji możesz również utworzyć bibliotekę składników, które można ponownie użyć. Tworząc bibliotekę składników, twórcy aplikacji mogą łatwo udostępniać i aktualizować jeden lub więcej składników innym twórcom.

Biblioteki komponentów są kontenerami definicji komponentów, które ułatwiają:

• Odkrywaj i wyszukuj komponenty.
• Publikowanie aktualizacji.
• Powiadamianie producentów aplikacji o dostępnych aktualizacjach składników.

Różnica między aplikacją a biblioteką składników

Biblioteka składników dostarcza scentralizowanego i zarządzanego repozytorium składników w celu wielokrotnego użytku.

Po utworzeniu biblioteki składników okienko Wstaw w lewym panelu nawigacyjnym domyślnie otwiera się na karcie Składniki. Podczas tworzenia aplikacji w tym widoku są wyświetlane ekrany zamiast składników.

Korzystając z opcji odtwarzania, można wyświetlić bibliotekę składników na ekranach znajdujących się w bibliotece. Po wybraniu karty składnika opcja odtwarzania jest wyłączona. Biblioteka składników nie jest wyświetlana w przypadku korzystania z Power Apps Mobile.

Praca z biblioteką składników

Użytkownik może utworzyć nową bibliotekę składników lub poddać edycji istniejącą bibliotekę składników z tego samego interfejsu. Przejdź do Power Apps> wybierz Więcej z lewej nawigacji > wybierz Odkryj wszystko> wybierz Biblioteki komponentów z sekcji Udoskonalenia aplikacji. Możesz także przypiąć opcję Biblioteki komponentów do swojego interfejsu Power Apps. Aby uzyskać więcej informacji, zobacz Nawigacja po lewej stronie w Power Apps.

Tworzenie przykładowej biblioteki składników

Kroki tworzenia składników znajdujących się w bibliotece składników są takie same, jak w przypadku tworzenia składników w aplikacji. Utworzysz bibliotekę komponentów, a następnie ponownie wykorzystasz kroki tworzenia komponentów z przykładu components overview example. Następnie użyjesz biblioteki składników, aby udostępnić składniki wielokrotnego użytku w nowej aplikacji.

1. Zaloguj się do usługi Power Apps.

2. Wybierz Biblioteki komponentów w lewym panelu nawigacyjnym, a następnie wybierz Nowa biblioteka komponentów. Alternatywnie, jeśli nie widzisz bibliotek składników w lewym okienku nawigacyjnym, wybierz pozycję Więcej w obszarze nawigacji po lewej stronie, wybierz przycisk Odnajdź wszystko , a następnie wybierz pozycję Biblioteki składników w sekcji Ulepszenia aplikacji .

3. Nazwij bibliotekę komponentów Komponenty menu; lub wybierz inną nazwę.

4. Wykonaj poniższe kroki, aby utworzyć komponenty na podstawie przykładu Przegląd komponentów. Nie musisz otwierać programu Power Apps Studio ani tworzyć nowej pustej aplikacji, ponieważ została już utworzona nowa biblioteka składników. Rozpocznij krok 2

   Po wykonaniu czynności tworzenia składników wykonaj kolejne kroki, aby dodać składniki do ekranu, oraz kroki umożliwiające utworzenie właściwości wyjściowych.

5. Po zakończeniu tworzenia i testowania składników zapisz bibliotekę składników, wybierając ikonę Zapisz z akcji aplikacji.

   Możesz również wybrać opcję Zapisz z notatkami do wersji w menu rozwijanym pod strzałką obok ikony Zapisz. Uwaga dotycząca wersji jest przydatna do pobierania wersji biblioteki składników oraz do uaktualniania składników używanych w aplikacjach z tej biblioteki składników. Aby uzyskać więcej informacji na temat akcji aplikacji, zobacz artykuł Understand Power Apps Studio (Omówienie programu Power Apps Studio).

   

   Porada

   Informacja o wersji jest przydatna podczas przeglądania wersji biblioteki składników oraz dla twórców aplikacji korzystających z tej biblioteki do przeglądania zmian i aktualizowania w razie potrzeby aplikacji korzystających z tych składników. Aby uzyskać więcej informacji, przejdź do sekcji aktualizacja biblioteki składników, aby poznać szczegóły.

6. Możesz opublikować zapisaną bibliotekę składników. Tylko opublikowane aktualizacje bibliotek składników są dostępne dla aplikacji, które korzystają z biblioteki składników. Wybierz ikonę Publikuj z akcji aplikacji, aby opublikować wersję biblioteki składników:

   

Dostosowywanie komponentów biblioteki

Podczas tworzenia składnika w bibliotece składników można określić, czy aplikacje korzystające ze składników biblioteki mogą dostosowywać składnik. Domyślnie to ustawienie jest włączone we właściwościach składników. Wyłącz to ustawienie , aby usunąć możliwość dostosowywania składnika w innych aplikacjach.

Po dodaniu składnika, który umożliwia dostosowanie, zobaczysz opcję edytowania tego składnika w celu uzyskania większego dostosowania. Aplikacja tworzy kopię lokalną i możesz wprowadzić zmiany w kopii składnika lokalnego. Skojarzenie z biblioteką składników zostanie usunięte po edycji składnika.

Wybranie opcji Edytuj komponent powoduje wyświetlenie monitu o skopiowanie komponentu lokalnie w celu dostosowania.

Jeśli nie zezwolisz na dostosowywanie składników, aplikacje zużywające nie wyświetlają opcji edytowania składnika.

W tym przypadku jedynym sposobem na edycję komponentu jest edycja biblioteki komponentów, w której komponent jest przechowywany.

Importuj z biblioteki składników

Po utworzeniu i opublikowaniu biblioteki składników aplikacje mogą korzystać ze składników z tej biblioteki składników, importując bibliotekę. Bibliotekę składników można również udostępniać.

Aby zaimportować istniejącą aplikację z biblioteki składników lub utworzyć nową aplikację, należy przeprowadzić jej edycję. Po otwarciu aplikacji w studio aplikacji kanwy — wybierz opcję Wstaw lub + po lewej stronie nawigacji. Następnie wybierz pozycję Pobierz więcej składników, aby wyświetlić listę bibliotek składników dostępnych w bieżącym środowisku:

Po prawej stronie ekranu zostanie wyświetlona lista bibliotek składników dostępnych w bieżącym środowisku. Wybierz pojedynczy składnik z biblioteki składników. Lub użyj opcji Wybierz wszystko, aby zaimportować wszystkie składniki z biblioteki jednocześnie:

Komponenty dostępne w aplikacji są wymienione w kategorii Niestandardowe na liście komponentów w okienku Wstawianie. Dostępne składniki z zaimportowanych z bibliotek składników są wymienione w kategorii Składniki biblioteczne:

Aktualizowanie biblioteki składników

Możesz modyfikować istniejącą bibliotekę komponentów i zapisywać wszelkie zmiany wraz z innymi uwagami do wersji. Zaktualizowaną wersję biblioteki składników należy jednak opublikować w celu użycia w istniejących aplikacjach korzystających z biblioteki składników. Przykładowa biblioteka składników zawiera opis sposobu publikowania biblioteki składników po jej zapisaniu.

Istnieją dwa sposoby, w jakie aplikacje korzystające z komponentów z biblioteki mogą uzyskać najnowsze zmiany.

Metoda 1: Powiadomienie o aktualizacji komponentu przy edycji aplikacji

Twórcy innych aplikacji otrzymują powiadomienia o dostępności zaktualizowanych składników. Powiadomienie pojawia się, gdy twórcy edytują aplikacje w Canvas App Studio. Użytkownik może wybrać opcję aktualizacji składników:

Wybierz pozycję Przejrzyj i zobaczysz opcję aktualizacji składnika:

Informacje o wersji dodawane podczas publikowania wersji biblioteki składników są wyświetlane tutaj.

Wybierz opcję Aktualizuj, aby zaktualizować składniki.

Metoda 2: Aktywne sprawdzanie aktualizacji

Ta metoda umożliwia proaktywne sprawdzanie aktualizacji aplikacji podczas pracy nad aplikacją w programie Studio.

Aby to sprawdzić, wybierz panel Wstaw składnik po lewej stronie, a następnie wybierz ikonę Sprawdź dostępność aktualizacji .

Jeśli istnieją aktualizacje składników używanych z biblioteki, zostanie wyświetlony komunikat umożliwiający przejrzenie i pobranie najnowszych zmian. Podczas przeglądania i aktualizowania aplikacja jest aktualizowana przy użyciu najnowszych składników.

Uaktualnianie komponentu z biblioteki składników w aplikacji konsumującej

W przypadku zaimportowania składnika z biblioteki składników nie można edytować go wewnątrz użytkowanej aplikacji. Jeśli wybierzesz pozycję Edytuj składnik, zobaczysz opcję utworzenia kopii składnika w bieżącej aplikacji, aby można było wprowadzić zmiany:

W przypadku wybrania opcji Utwórz kopię składnik zostanie skopiowany do lokalnej aplikacji. Kopia lokalna składnika zostanie wyświetlona w obszarze kategorii Niestandardowej w okienku Wstaw. Ta lokalna kopia składnika nie otrzymuje aktualizacji, jeśli zostanie opublikowana później nowa wersja źródłowej biblioteki składników.

Usuwanie biblioteki składników

Jeśli do biblioteki składników odwołuje się aplikacja kanwowa, nie można jej usunąć. Ten warunek ma zastosowanie zarówno do środowisk Power Platform, jak i środowisk innych niż Power Platform. Przed usunięciem biblioteki usuń składnik z aplikacji. Informacje o aplikacjach korzystających z biblioteki składników możesz znaleźć w widoku zależności rozwiązania lub w komunikacie, który jest wyświetlany przy próbie usunięcia biblioteki.

Uprawnienia dotyczące bibliotek składników

Udostępnianie biblioteki komponentów działa tak samo jak udostępnianie aplikacji kanwowej. Udostępniając bibliotekę składników, można zezwolić innym osobom na ponowne korzystanie z biblioteki składników. Po udostępnieniu inni użytkownicy mogą edytować bibliotekę składników i importować składniki z tej biblioteki składników udostępnionych, aby tworzyć i edytować aplikacje. Jeśli biblioteka składników zostanie udostępniona użytkownikowi jako współwłaścicielowi, może on jej używać, edytować ją i udostępniać, ale nie może jej usunąć ani zmienić właściciela.

Dodatkowe uwagi dotyczące udostępniania bibliotek składników grupom zabezpieczeń:

• Nie można używać interfejsu użytkownika udostępniania podczas udostępniania bibliotek komponentów utworzonych jako część rozwiązania. Zamiast tego można użyć polecenia cmdlet Set-PowerAppRoleAssignment z poziomem uprawnień CanEdit w celu udostępnienia bibliotek składników wybranej grupie zabezpieczeń.
• Biblioteki składników utworzone w środowisku Power Platform bez bazy danych Dataverse, udostępniane z uprawnieniem Współwłaściciel, automatycznie przyznają uprawnienie CanEdit wybranej grupie zabezpieczeń.

Znane ograniczenia

• Znane ograniczenia , które mają zastosowanie do składników, dotyczą również bibliotek składników.

• Nie można importować składników z lokalnie zapisanej biblioteki składników. Bibliotekę składników można pobrać, wybierając pozycję Pobierz kopię z akcji aplikacji. Jeśli jednak spróbujesz zaimportować tę zapisaną bibliotekę składników, zostanie wyświetlony następujący komunikat o błędzie:

  

• Jeśli importujesz aplikację i bibliotekę składników do środowiska po raz pierwszy, upewnij się, że aplikacja używa najnowszej wersji składników dołączonego do biblioteki. W przeciwnym razie aplikacja nie będzie otrzymywać aktualizacji po zaimportowaniu. Aplikacja będzie rozpoznawać i monitować o zaktualizowaną wersję przy kolejnych importach biblioteki składników do tego samego środowiska.

• Składniki kodu nie są obsługiwane wewnątrz bibliotek składników.

Zobacz też

• Składniki kanwy
• Biblioteka składników – zarządzanie cyklem życia aplikacji (ALM)
• Mapowanie pól wejściowych składnika
• Dodawanie multimediów do składnika
• Formuły zachowania składników
• Struktura składników usługi Power Apps
• Dodawanie składników kanwy do niestandardowej strony w aplikacji opartej na modelu