Sdílet prostřednictvím

Řešení chyb instalace knihovny

  • Článek

V některých případech se při instalaci podpůrných knihoven Androidu můžou zobrazit chyby. Tato příručka obsahuje alternativní řešení některých běžných chyb.

Přehled

Při sestavování projektu aplikace Xamarin.Android může dojít k chybám sestavení při pokusu o stažení a instalaci knihoven závislostí sady Visual Studio nebo Visual Studio pro Mac. Mnohé z těchto chyb jsou způsobené problémy s připojením k síti, poškozením souboru nebo problémy se správou verzí. Tato příručka popisuje nejběžnější chyby instalace knihovny podpory a obsahuje postup pro řešení těchto problémů a opětovné sestavení projektu aplikace.

Chyby při stahování m2Repository

Při odkazování na balíček NuGet knihoven podpory androidu nebo služeb Google Play se můžou zobrazit chyby m2repository . Chybová zpráva vypadá přibližně takto:

Download failed. Please download https://dl-ssl.google.com/android/repository/android_m2repository_r16.zip and extract it to the C:\Users\mgm\AppData\Local\Xamarin\Android.Support.v4\22.2.1\content directory.

Tento příklad je určený pro android_m2repository_r16, ale může se zobrazit stejná chybová zpráva pro jinou verzi, jako je android_m2repository_r18 nebo android_m2repository_r25.

Automatické obnovení z chyb m2repository

Tento problém lze často odstranit odstraněním problematické knihovny a opětovným sestavením podle těchto kroků:

  1. Přejděte do adresáře knihovny podpory v počítači:

    • Ve Windows jsou knihovny podpory umístěné v umístění C:\Users\username\AppData\Local\Xamarin.

    • V systému Mac OS X jsou knihovny podpory umístěné ve složce /Users/username/.local/share/Xamarin.

  2. Vyhledejte knihovnu a složku verze odpovídající chybové zprávě. Například knihovna a složka verze pro výše uvedenou chybovou zprávu se nachází v Android.Support.v4\22.2.1:

    Příklad umístění složky pro knihovnu podpory 22.2.1

  3. Odstraňte obsah složky verze. Nezapomeňte odebrat soubor .zip i obsah a vložené podadresáře v této složce. V příkladu chybové zprávy uvedené výše se odstraní soubory a podadresáře zobrazené na tomto snímku obrazovky (obsah, vložený a android_m2repository_r16.zip):

    Příklad obsahu složky knihovny podpory 22.2.1

    Všimněte si, že je důležité odstranit celý obsah této složky. I když tato složka může zpočátku obsahovat chybějící soubor android_m2repository_r16.zip , pravděpodobně byl tento soubor částečně stažen nebo poškozen.

  4. Znovu sestavte projekt – tím dojde k tomu, že proces sestavení znovu stáhne chybějící knihovnu.

Ve většině případů tyto kroky vyřeší chybu sestavení a umožní vám pokračovat. Pokud odstranění této knihovny chybu sestavení nevyřeší, musíte ručně stáhnout a nainstalovat soubor android_m2repository_r_nn_.zip , jak je popsáno v další části.

Ruční stahování m2repository

Pokud jste se pokusili použít výše uvedený postup automatického obnovení a stále máte chyby sestavení, můžete ručně stáhnout soubor android_m2repository_r_nn_.zip (pomocí webového prohlížeče) a nainstalovat ho podle následujících kroků. Tento postup je užitečný také v případě, že nemáte přístup k internetu ve vývojovém počítači, ale archiv si můžete stáhnout pomocí jiného počítače.

  1. Stáhněte si soubor android_m2repository_r_nn_.zip, který odpovídá chybové zprávě – odkazy jsou uvedeny v následujícím seznamu (spolu s odpovídající hodnotou hash MD5 adresy URL každého odkazu):

    • android_m2repository_r33.zip – 5FB756A25962361D17BBE99C3B3FCC44

    • android_m2repository_r32.zip – F16A3455987DBAE5783F058F19F7FCDF

    • android_m2repository_r31.zip – 99A8907CE2324316E754A95E4C2D786E

    • android_m2repository_r30.zip – 05AD180B8BDC7C21D6BCB94DDE7F2C8F

    • android_m2repository_r29.zip – 2A3A8A6D6826EF6CC653030E7D695C41

    • android_m2repository_r28.zip – 17BE247580748F1EDB72E9F374AA0223

    • android_m2repository_r27.zip – C9FD4FCD69D7D12B1D9DF076B7BE4E1C

    • android_m2repository_r26.zip – 8157FC1C311BB36420C1D8992AF54A4D

    • android_m2repository_r25.zip – 0B3F1796C97C707339FB13AE8507AF50

    • android_m2repository_r24.zip – 8E3C9EC713781EDFE1EFBC5974136BEA

    • android_m2repository_r23.zip – D5BB66B3640FD9B9C6362C9DB5AB0FE7

    • android_m2repository_r22.zip – 96659D653BDE0FAEDB818170891F2BB0

    • android_m2repository_r21.zip – CD3223F2EFE068A26682B9E9C4B6FBB5

    • android_m2repository_r20.zip – 650E58DF02DB1A832386FA4A2DE46B1A

    • android_m2repository_r19.zip – 263B062D6EFAA8AE39E9460B8A5851A

    • android_m2repository_r18.zip – 25947AD38DCB4865ABEB61522FAFDA0E

    • android_m2repository_r17.zip – 49054774F44AE5F35A6BA9D3C117EFD8

    • android_m2repository_r16.zip – 0595E577D19D31708195A8308781EE6

    Pokud se v této tabulce nezobrazí archiv m2repository, můžete vytvořit adresu URL pro stažení tak https://dl-ssl.google.com/android/repository/ , že před název souboru m2repository stáhnete. Můžete například https://dl-ssl.google.com/android/repository/android\_m2repository\_r_nn_.zip stáhnout android_m2repository_r_nn_.zip.

  2. Přejmenujte soubor na odpovídající hodnotu hash MD5 adresy URL pro stažení, jak je znázorněno v předchozí tabulce. Pokud jste například stáhli android_m2repository_r25.zip, přejmenujte ho na 0B3F1796C97C707339FB13AE8507AF50.zip. Pokud se v tabulce nezobrazí hodnota hash MD5 pro adresu URL pro stažení staženého souboru, můžete pomocí online generátoru MD5 převést adresu URL na hashový řetězec MD5.

  3. Zkopírujte soubor do složky zip Xamarin:

    • Ve Windows se tato složka nachází v umístění C:\Users\username\AppData\Local\Xamarin\zips.

    • V systému Mac OS X se tato složka nachází ve složce /Users/username/.local/share/Xamarin/zips.

    Například následující snímek obrazovky znázorňuje výsledek při stažení android_m2repository_r16.zip a přejmenování na hodnotu hash MD5 adresy URL pro stažení ve Windows:

    Příklad přejmenování úložiště r16.zip na 0595E577D19D31708195A83087881EE6.zip

Pokud tento postup chybu sestavení nevyřeší, musíte ručně stáhnout soubor android_m2repository_r_nn_.zip , rozbalit ho a nainstalovat jeho obsah, jak je popsáno v další části.

Ruční stahování a instalace souborů m2repository

Úplný ruční proces zotavení z chyb m2repository zahrnuje stažení souboru android_m2repository_r_nn_.zip (pomocí webového prohlížeče), jeho rozbalení a zkopírování jeho obsahu do adresáře knihovny podpory ve vašem počítači. V následujícím příkladu se z této chybové zprávy obnovíme:

Unzipping failed. Please download https://dl-ssl.google.com/android/repository/android_m2repository_r25.zip and extract it to the C:\Users\mgm\AppData\Local\Xamarin\Android.Support.v4\23.1.1\content directory.

Pomocí následujícího postupu stáhněte m2repository a nainstalujte jeho obsah:

  1. Odstraňte obsah složky knihovny odpovídající chybové zprávě. Například ve výše uvedené chybové zprávě byste odstranili obsah C:\Users\username\AppData\Local\Xamarin\Android.Support.v4\23.1.1.0. Jak je popsáno výše, musíte odstranit celý obsah tohoto adresáře:

    Odstranění obsahu, vložených a android_m2repository složek ze složky 23.1.1.0

  2. Stáhněte si soubor android_m2repository_r_nn_.zip z Googlu, který odpovídá chybové zprávě (viz tabulka v předchozí části s odkazy).

  3. Extrahujte tento .zip archiv do libovolného umístění (například desktopu). Tím by se měl vytvořit adresář, který odpovídá názvu archivu .zip . V tomto adresáři byste měli najít podadresář s názvem m2repository:

    Složka m2repository nalezená v extrahovaném archivu zip

  4. V adresáři knihovny s verzemi, který jste vyprázdnili v kroku 1, znovu vytvořte obsah a vložené podadresáře. Například následující snímek obrazovky znázorňuje vytváření obsahu a vložených podadresářů ve složce 23.1.1.0 pro android_m2repository_r25.zip:

    Vytvoření obsahu a vložených složek ve složce 23.1.1.0

  5. Zkopírujte m2repository z extrahovaného .zip do adresáře obsahu , který jste vytvořili v předchozím kroku:

    Snímek obrazovky m2repository zkopírovaného do složky 23.1.1.0/content

  6. V extrahovaném adresáři .zip přejděte na adresu m2repository\com\android\support\support-v4 a otevřete složku odpovídající výše vytvořenému číslu verze (v tomto příkladu 23.1.1):

    Příklad výpisu souborů obsažených ve složce support-v4/23.1.1

  7. Zkopírujte všechny soubory v této složce do vloženého adresáře vytvořeného v kroku 4:

    Příklad souborů zkopírovaných do složky 23.1.1.0/embedded

  8. Ověřte, že jsou všechny soubory zkopírovány. Vložený adresář by teď měl obsahovat soubory, jako jsou .jar, .aar a .pom.

  9. Rozbalte obsah všech extrahovaných souborů .aar do vloženého adresáře. Ve Windows připojte k souboru .aar příponu .zip, otevřete ho a zkopírujte obsah do vloženého adresáře. V systému macOS rozbalte soubor .aar pomocí příkazu unzip v terminálu (například rozbalte soubor.aar).

V tomto okamžiku jste ručně nainstalovali chybějící komponenty a projekt by se měl sestavit bez chyb. Pokud ne, ověřte, že jste stáhli archivní verzi m2repository .zip , která přesně odpovídá verzi v chybové zprávě, a ověřte, že jste nainstalovali jeho obsah do správných umístění, jak je popsáno v předchozích krocích.

Shrnutí

Tento článek vysvětluje, jak se zotavit z běžných chyb, které se můžou provést během automatického stahování a instalace knihoven závislostí. Popisuje, jak odstranit problematickou knihovnu a znovu sestavit projekt jako způsob opětovného stažení a opětovné instalace knihovny. Popisuje, jak stáhnout knihovnu a nainstalovat ji do složky zips . Popsal také postup, který se týká ručního stahování a instalace potřebných souborů, jako způsob řešení problémů, které nelze vyřešit automatickými prostředky.