Użyj wersji formantu Git do edycji aplikacji kanw (eksperymentalne)

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Ważne

  • Ta funkcja jest wdrażana i w zależności od regionu może nie być jeszcze dostępna dla dzierżawy. Sprawdź przełącznik eksperymentalny opisany w Włączanie kontroli wersji Git, aby dowiedzieć się, czy funkcja jest dostępna w dzierżawie.
  • To jest funkcja objęta programem eksperymentalnym. Jest on domyślnie wyłączony i musi być włączony przed użyciem.
  • Funkcje w wersji eksperymentalnej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Możesz teraz użyć eksperymentalnej funkcji formantu wersji Git, aby umożliwić więcej niż jednej osobie edytowanie aplikacji kanwy w tym samym czasie. Dzięki tej funkcji inni nie zostaną zablokowani w aplikacji, gdy jedna osoba ją edytuje. Gdy zmiany są wprowadzane i synchronizowane, są automatycznie scalane z innymi zmianami i udostępniane wszystkim innym osobom edytującym aplikację.

Git jest używany jako magazyn zapasowy dla tej funkcji. Po wstępnej konfiguracji z połączeniem z Git każdy użytkownik może korzystać z tej funkcji bez żadnych dodatkowych kroków konfiguracyjnych, z wyjątkiem uwierzytelniania za pomocą Git.

Każdy dostawca Git może być używany z Power Apps Studio—takimi jak GitHub lub Azure DevOps. Użyj istniejących narzędzi Git, aby wyświetlić historię wersji, tworzyć żądania ściągnięcia i zarządzać nimi oraz wykonywać inne zadania kontroli wersji.

Uwaga

  • Przed rozpoczęciem upewnij się, że przeczytałeś znane ograniczenia tej funkcji. Korzystanie z Git ewoluuje i może zmienić sposób działania tej funkcji. Aby uzyskać aktualizacje i podzielić się opiniami na temat tej funkcji, zajmij się na forum społeczności Power Apps.
  • Kontrola wersji Git jest zarządzana dla aplikacji. Każda aplikacja musi być indywidualnie dodana do kontroli wersji Git.
  • Gdy kontrola wersji git zostanie włączona, autozapisywanie twojej aplikacji zostanie wyłączone. Będziesz musiał ręcznie zapisać lub zsynchronizować swoje zmiany.

Włącz kontrolę wersji Git

Wykonaj poniższe kroki, aby włączyć kontrolę wersji Git w aplikacji.

  1. Utwórz nową aplikację lub otwórz istniejącą aplikację, którą chcesz dodać do kontroli wersji Git.

  2. Wybierz Ustawienia w Power Apps Studio.

  3. Wybierz Nadchodzące funkcje.

  4. Wybierz Eksperymentalny.

  5. Przewiń w dół do pozycji Pokaż ustawienie kontroli wersji Git i włącz je w pozycji Wł..

  6. Zobaczysz nowy element kontroli wersji Git po lewej stronie okienka ustawień.

    Przełącz, aby włączyć kontrolę wersji Git.

    Porada

    W przypadku innych problemów z tą funkcją odwiedź forum społeczności Power Apps.

Łączenie aplikacji z Git

Wykonaj te kroki, aby połączyć aplikację z Git.

  1. Wybierz Ustawienia w Power Apps Studio.

  2. Wybierz Kontrola wersji usługi Git.

    Przycisk, aby rozpocząć połączenie z git dla tej aplikacji.

  3. Wybierz pozycję Połącz i wypełnij informacje o połączeniu Git dla tej aplikacji.

    Pola wprowadzania tekstu w celu dostarczenia informacji o połączeniu git.

    • Adres URL repozytorium Git: adres URL, którego normalnie używasz z narzędziami Git. W przypadku Azure DevOps, pamiętaj o dołączenie części adresu URL /_git/repo takiej jak https://contoso.visualstudio.com/_git/repo.
    • Odgałęzienie : Nazwa gałęzi, której należy użyć.
    • Katalog: Katalog w obrębie oddziału do użycia. Aplikacji kanwy nie można przechowywać w katalogu głównym gałęzi.

    Zostanie wyświetlony monit o utworzenie oddziału lub katalogu, jeśli nie istnieje. Jeśli gałąź i katalog zawiera już aplikację kanwy, bieżąca aplikacja zostanie zamknięta, a istniejąca aplikacja zostanie załadowana z Git.

    Po nawiązaniu połączenia zostaną wyświetlone informacje o połączeniu.

Uwierzytelnianie przy użyciu usługi Git

Power Apps wymaga użycia osobistego token dostępu zamiast hasła do konta dostawcy kontroli wersji.

Uwaga

Osobisty token dostępu nie jest taki sam jak hasło, zarówno dla Power Apps, jak i dla Twojego dostawcy Git. Aby korzystać z tej funkcji, musisz utworzyć osobisty token dostępu.

Różni dostawcy kontroli wersji mają różne metody generowania osobistych tokenów dostępu. Postępuj zgodnie z poniższymi instrukcjami, aby uzyskać osobisty token dostępu.

Podczas edytowania aplikacji połączonych z Git zostanie wyświetlony monit o podanie nazwy użytkownika i hasła. Wprowadź swoją nazwę użytkownika i token dostępu w tym oknie dialogowym, aby uwierzytelnić się za pomocą Git.

Okno dialogowe prosi o nazwę użytkownika Git i token dostępu (jako hasło).

Uwaga

Poświadczenia Git nie są przechowywane Power Apps między sesjami. Jeśli chcesz, możesz użyć ustawień przeglądarki, aby zapisać informacje o formularzu do ponownego użycia, aby uniknąć częstego wprowadzania poświadczeń.

Wprowadzanie zmian w aplikacji

Po połączeniu aplikacji z Git wszystko, co musisz zrobić, to uwierzytelnić się za pomocą poświadczeń Git, aby otworzyć i edytować aplikację. Nie musisz przechodzić przez pojęcia Git podczas korzystania z tej funkcji, aby ładować, edytować, zapisywać, publikować i udostępniać aplikację.

Użyj nowego przycisku synchronizacji u góry ekranu Studio (między przyciskami Sprawdzanie aplikacji i Cofnij), aby scalić wszelkie bieżące zmiany z tym, co jest w Git, i przenieść wynik do Studio w celu dalszej edycji.

Przycisk do synchronizacji zmian z repozytorium Git.

Ważne

Aplikacja będzie musiała być ładowana za każdym razem, gdy nastąpi scalenie. Jeśli aplikacja jest duża, to obciążenie może zająć trochę czasu.

Po nawiązaniu połączenia z Git zmiany są przechowywane w systemie Git, a nie w programie Power Apps. Nieopublikowane wersje nie będą wyświetlane w portalu twórców Power Apps.

Scal wyniki

Obecnie nie ma opcji rozwiązywania konfliktów scalania. Studio spróbuje automatycznie scalić i naprawić konflikty dzięki semantycznej znajomości aplikacji (na przykład typom obiektów i innym zmianom w aplikacji). Ponieważ wszystkie zmiany są nadal przechowywane w systemie Git, zawsze możesz pobrać zmiany w aplikacji, aby ponownie je zastosować, jeśli automatyczne scalanie nie spełnia wymagań biznesowych.

Opublikuj aplikację

Aplikacje połączone z Git nadal działają normalnie na potrzeby publikowania i środowiska użytkownika bez żadnych zmian w tym procesie. Gdy publikujesz aplikację, wersja aplikacji jest przechowywana w Power Apps, ponieważ Power Apps wymaga uruchomionej kopii aplikacji do udostępnienia użytkownikom.

Żądania ściągnięcia, historia przeglądania, obwinianie i inne funkcje Git

Praca z żądaniami ściągnięcia lub innymi operacjami Git musi być wykonywana za pomocą innych narzędzi Git, w tym witryny dostawcy Git. Nie ma dostępnej opcji wykonywania takich operacji Git w celu ściągania lub wypychania zatwierdzeń.

Każde zapisanie lub synchronizacja, która zawiera zmiany, spowoduje zatwierdzenie w Git. Jeśli w Git wystąpiły inne zmiany, na przykład przez innych twórców, zostaną wprowadzone dodatkowe zatwierdzenia w celu scalenia wyników wszystkich zmian. Żadne zmiany nie zostaną utracone, nawet jeśli scalanie zastąpi edycję. Zmiany wprowadzone przez każdego twórcę są przechowywane w systemie Git za pomocą zatwierdzeń.

Znane ograniczenia

Ponieważ ta funkcja jest eksperymentalna, czekamy na Wasze opinie. Poniżej wymieniono znane ograniczenia. Planujemy usunąć większość tych ograniczeń w przyszłych wersjach.

  • Ta funkcja nie jest zgodna ze składnikami kodu. Nie używaj tej funkcji w aplikacjach, które używają składników kodu.
  • Ta funkcja nie jest kompatybilna z lokalnymi repozytoriami Git. Repozytorium Git musi być hostowane w Internecie i dostępne za pomocą nazwy użytkownika i osobistego tokena dostępu.
  • Edycje tej samej właściwości w tej samej kontrolce nie są scalane. Ostatnia dokonana edycja wygra.
  • Nie możesz przywrócić aplikacji kanw do poprzedniej wersji, korzystając z kroków opisanych w artykule Przywróć aplikację. Zamiast tego będziesz musiał użyć Git do przywrócenia aplikacji do poprzedniej wersji. Aby uzyskać więcej informacji, zobacz następujące zasoby:
  • Łączenie wielu aplikacji do tego samego katalogu może powodować problemy. Obejmuje to tworzenie kopii aplikacji oraz eksportowanie i importowanie ich.
  • Problemy z połączeniem mogą powodować problemy w przypadku wszystkich plików istniejących w repozytorium, których długość przekracza 180 znaków. Zaleca się użycie dedykowanego repozytorium dla połączonych aplikacji.
  • Wybranie polecenia Zamknij w menu Plik może spowodować usunięcie dostosowań z aplikacji. Dostosowania nie są jednak usuwane. Odśwież stronę, aby ponownie wyświetlić wszystkie dostosowania.
  • Jeśli otworzysz aplikację niezwią połączeniową (na przykład Aplikacja A) z poziomu połączonej aplikacji (na przykład Aplikacja B) (Plik > Otwórz) i spróbujesz połączyć aplikację A z repozytorium, parametry formantu wersji nowej aplikacji będą takie same jak w aplikacji B. W takim przypadku należy odświeżyć stronę i ponownie spróbować połączyć aplikację A z repozytorium.
  • Ta funkcja nie obsługuje zmiany nazwy składników niestandardowych.
  • Jeśli zobaczysz komunikat o tym, że aplikacja jest otwarta do edycji przez innego użytkownika, poproś przywoływego użytkownika o odświeżenie aplikacji. Później możesz odświeżyć aplikację, aby usunąć blokowanie.
  • Ta funkcja nie jest zgodna z testami w programie Test Studio i stronami niestandardowymi dla aplikacji opartych na modelu
  • Ta funkcja nie obsługuje korzystania z tokenów dostępu osobistego, które są autoryzowane do użycia z logowaniem jednokrotnym przy użyciu aplikacji SAML.

Opinie na forum społeczności

Przekaż nam swoją opinię! Ta funkcja jest pierwszym krokiem w długiej podróży, aby umożliwić wspaniałe wrażenia z rozwoju zespołu. Odwiedź forum społeczności Power Apps, aby uzyskać aktualizacje i przekazać opinię.