Korzystanie z pakietów z repozytorium Google Maven

Usługi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Dzięki Azure Artifacts deweloperzy mogą umożliwić nadrzędnym źródłom wykorzystanie pakietów z publicznych rejestrów, takich jak Google Maven Repository. Po włączeniu źródła nadrzędnego Azure Artifacts automatycznie zapisuje kopię dowolnego pakietu zainstalowanego w kanale informacyjnym przez użytkowników z uprawnieniami Feed i Upstream Reader (Współpracownik) lub wyższym. Azure Artifacts obsługuje również inne źródła nadrzędne maven, w tym Maven Central, Gradle Plugins i JitPack.

Wymagania wstępne

produkt Wymagania
Azure DevOps - Organizacja Azure DevOps .
- Azure DevOps project.

Tworzenie kanału informacyjnego

Jeśli masz już kanał informacyjny Azure Artifacts, przejdź do następnej sekcji. W przeciwnym razie utwórz nowy, wykonując następujące kroki:

  1. Zaloguj się do Azure DevOps i przejdź do swojego projektu.

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz kanał.

  3. Wprowadź nazwę kanału, ustaw Widoczność, aby kontrolować, kto może wyświetlać pakiety, oraz wybierz zakres kanału. Wybierz pozycję Uwzględnij pakiety z typowych źródeł publicznych, aby włączyć źródła nadrzędne i pozwolić na korzystanie z publicznych rejestrów.

  4. Wybierz pozycję Utwórz , aby zakończyć.

Dodawanie nadrzędnego źródła repozytorium Google Maven

Jeśli podczas tworzenia kanału informacyjnego wybrano opcję Uwzględnij pakiety ze wspólnych źródeł publicznych , repozytorium Google Maven powinno już zostać dodane jako nadrzędne źródło. Jeśli nie, możesz dodać ją ręcznie, wykonując następujące kroki:

  1. Zaloguj się do organizacji Azure DevOps i przejdź do projektu.

  2. Wybierz Artefakty, a następnie wybierz ikonę koła zębatego w prawym górnym rogu, aby otworzyć Ustawienia kanału.

  3. Wybierz Źródła nadrzędne, a następnie wybierz Dodaj strumień nadrzędny.

  4. Wybierz pozycję Źródło publiczne, a następnie wybierz pozycję Repozytorium Google Maven (https://maven.google.com/web/index.html).

  5. Wybierz pozycję Dodaj, a następnie wybierz pozycję Zapisz w prawym górnym rogu, aby zapisać zmiany.

Zapisywanie pakietów z repozytorium Google Maven

Przed rozpoczęciem upewnij się, że projekt Maven jest skonfigurowany do nawiązywania połączenia z kanałem informacyjnym Azure Artifacts. Jeśli jeszcze tego nie zrobiłeś, postępuj zgodnie z instrukcjami w konfiguracji projektu, aby skonfigurować projekt Maven i uwierzytelnić się za pomocą kanału.

W poniższym przykładzie pokazano, jak zainstalować platformę tożsamości Multipaz , open source z repozytorium Google Maven.

  1. Przejdź do repozytorium https://maven.google.comGoogle Maven .

  2. Wyszukaj pakiet Multipaz : org.multipaz, a następnie wybierz pakiet i wersję, której chcesz użyć.

  3. Skopiuj wartości Identyfikator grupy, Identyfikator artefaktu i Wersja pakietu.

  4. Zastąp symbole zastępcze w poniższym fragmencie kodu wartościami, które właśnie skopiowano:

    <dependency>
        <groupId>GROUP_ID</groupId>
        <artifactId>ARTIFACT_ID</artifactId>
        <version>VERSION</version>
    </dependency>
    
  5. Otwórz plik pom.xml , wklej fragment kodu zależności w <dependencies> sekcji, a następnie zapisz plik.

  6. Uruchom następujące polecenie z tej samej ścieżki co plik pom.xml , aby zainstalować zależność:

    mvn install
    

Po zakończeniu polecenia narzędzie Maven rozwiązuje zależność za pośrednictwem kanału informacyjnego Azure Artifacts. Jeśli pakiet nie jest jeszcze obecny w kanale, Azure Artifacts pobiera go z Google Maven Repository i zapisuje jego kopię. Kolejne instalacje pobierają pakiet bezpośrednio z Azure Artifacts zamiast rejestru publicznego.

Uwaga

Aby zapisać pakiety z kanału nadrzędnego, musisz mieć rolę Feed and Upstream Reader (Collaborator) lub wyższą. Aby uzyskać więcej informacji, zobacz Role i uprawnienia kanału informacyjnego .

Wyświetlanie zapisanych pakietów

Możesz potwierdzić, że po zainstalowaniu pakietu ze źródła nadrzędnego Azure Artifacts zapisano kopię w strumieniu.

  1. Zaloguj się do Azure DevOps i przejdź do swojego projektu.

  2. Wybierz Artefakty, a następnie wybierz swój kanał informacyjny z menu rozwijanego.

  3. Z menu rozwijanego Źródło wybierz pozycję Repozytorium Google Maven , aby wyświetlić pakiety zapisane z tego nadrzędnego źródła.

  4. Pakiet Multipaz, który zainstalowałeś w poprzedniej sekcji, jest teraz dostępny w kanale. Azure Artifacts automatycznie zapisuje kopię podczas uruchamiania polecenia mvn install.

    Zrzut ekranu przedstawiający pakiet Multipaz z repozytorium Google Maven zapisany w kanale informacyjnym.

Napiwek

Jeśli narzędzie Maven nie pobierze wszystkich zależności, uruchom następujące polecenie z katalogu projektu, aby ponownie wygenerować pliki projektu i pobrać źródła i dokumenty Javadocs: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true