라이브러리 설치 오류 해결Resolving Library Installation Errors

일부 경우에 Android 지원 라이브러리를 설치 하는 동안 오류가 발생할 수 있습니다. 이 가이드에서는 몇 가지 일반적인 오류에 대 한 해결 방법을 제공 합니다.In some cases, you may get errors while installing Android support libraries. This guide provides workarounds for some common errors.

개요Overview

Xamarin Android 앱 프로젝트를 빌드하는 동안 Visual Studio 또는 Mac용 Visual Studio 종속성 라이브러리를 다운로드 하 고 설치 하려고 할 때 빌드 오류가 발생할 수 있습니다.While building a Xamarin.Android app project, you may get build errors when Visual Studio or Visual Studio for Mac attempt to download and install dependency libraries. 이러한 오류의 상당수는 네트워크 연결 문제, 파일 손상 또는 버전 관리 문제로 인해 발생 합니다.Many of these errors are caused by network connectivity issues, file corruption, or versioning problems. 이 가이드에서는 가장 일반적인 지원 라이브러리 설치 오류에 대해 설명 하 고 이러한 문제를 해결 하 고 앱 프로젝트 빌드를 다시 시작 하는 단계를 제공 합니다.This guide describes the most common support library installation errors and provides the steps to work around these issues and get your app project building again.

M2Repository를 다운로드 하는 동안 오류 발생Errors While Downloading m2Repository

Android 지원 라이브러리 또는 Google Play 서비스의 NuGet 패키지를 참조할 때 m2repository 오류가 표시 될 수 있습니다.You may see m2repository errors when referencing a NuGet package of the Android Support Libraries or Google Play services. 오류 메시지는 다음과 유사합니다.The error message resembles the following:

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.

이 예제는 android_m2repository_r16에 대 한 것 이지만 android_m2repository_r18 또는 android_m2repository_r25와 같은 다른 버전에 대해서도 동일한 오류 메시지가 표시 될 수 있습니다.This example is for android_m2repository_r16, but you may see this same error message for a different version such as android_m2repository_r18 or android_m2repository_r25.

M2repository 오류에서 자동 복구Automatic Recovery from m2repository Errors

이러한 단계에 따라 문제 라이브러리를 삭제 하 고 다시 작성 하 여이 문제를 해결할 수 있는 경우가 많습니다.Often, this issue can be remedied by deleting the problematic library and rebuilding according to these steps:

  1. 컴퓨터의 지원 라이브러리 디렉터리로 이동 합니다.Navigate to the support library directory on your computer:

    • Windows에서 지원 라이브러리는 C:\사용자\사용자 이름\AppData\로컬\Xamarin에 있습니다.On Windows, support libraries are located at C:\Users\username\AppData\Local\Xamarin.

    • Mac OS X에서 지원 라이브러리는 /사용자/사용자 이름/ a s/p r o r e r/p r o v e r s에 있습니다On Mac OS X, support libraries are located at /Users/username/.local/share/Xamarin.

  2. 오류 메시지에 해당 하는 라이브러리 및 버전 폴더를 찾습니다.Locate the library and version folder corresponding to the error message. 예를 들어 위의 오류 메시지에 대 한 library 및 version 폴더는 Android. Support. v4\22.2.1에 있습니다.For example, the library and version folder for the above error message is located at Android.Support.v4\22.2.1:

    22.2.1 지원 라이브러리에 대 한예제 폴더 위치Example folder location for 22.2.1 support library

  3. 버전 폴더의 내용을 삭제 합니다.Delete the contents of the version folder. .Zip 파일 뿐만 아니라이 폴더에 포함 된 콘텐츠포함 된 하위 디렉터리도 제거 해야 합니다.Be sure to remove the .zip file as well as the content and embedded subdirectories within this folder. 위에 표시 된 예제 오류 메시지의 경우이 스크린샷 (content, embeddedandroid_m2repository_r16)에 표시 된 파일과 하위 디렉터리를 삭제 합니다.For the example error message shown above, the files and subdirectories shown in this screenshot (content, embedded, and android_m2repository_r16.zip) are to be deleted:

    22.2.1 지원 라이브러리 폴더의예제 내용Example contents of 22.2.1 support library folder

    이 폴더의 전체 콘텐츠를 삭제 하는 것이 중요 합니다.Note that it is important to delete the entire contents of this folder. 이 폴더에는 처음에 "누락 된" android_m2repository_r16 파일이 포함 되어 있지만이 파일이 부분적으로 다운로드 되었거나 손상 되었을 수 있습니다.Although this folder may initially contain the "missing" android_m2repository_r16.zip file, this file may have been partially downloaded or corrupted.

  4. – 프로젝트를 다시 빌드하면 빌드 프로세스에서 누락 된 라이브러리를 다시 다운로드 하 게 됩니다.Rebuild the project – doing so will cause the build process to re-download the missing library.

대부분의 경우 이러한 단계를 수행 하면 빌드 오류가 해결 되어 계속 진행할 수 있습니다.In most cases, these steps will resolve the build error and allow you to continue. 이 라이브러리를 삭제 해도 빌드 오류가 해결 되지 않으면 다음 섹션에 설명 된 대로 android_m2repository_r_nn_ 파일을 수동으로 다운로드 하 여 설치 해야 합니다.If deleting this library does not resolve the build error, you must manually download and install the android_m2repository_r_nn_.zip file as described in the next section.

수동으로 m2repository 다운로드Manually Downloading m2repository

위의 자동 복구 단계를 사용 하 여 빌드 오류가 계속 발생 하는 경우 android_m2repository_r_nn_ 파일 (웹 브라우저를 사용 하 여)을 수동으로 다운로드 하 여 다음 단계에 따라 설치할 수 있습니다.If you have tried using the automatic recovery steps above and still have build errors, you can manually download the android_m2repository_r_nn_.zip file (using a web browser) and install it according to the following steps. 이 절차는 개발 컴퓨터에서 인터넷에 액세스할 수 없지만 다른 컴퓨터를 사용 하 여 보관 파일을 다운로드할 수 있는 경우에도 유용 합니다.This procedure is also useful if you do not have internet access on your development computer but you are able to download the archive using a different computer.

  1. 다음 목록 (각 링크 URL의 해당 MD5 해시와 함께)에 제공 되는 오류 메시지 –에 해당 하는 android_m2repository_r_nn_ 파일을 다운로드 합니다.Download the android_m2repository_r_nn_.zip file that corresponds to the error message – links are provided in the following list (along with the corresponding MD5 hash of each link's URL):

    M2repository archive가이 테이블에 표시 되지 않으면 다운로드할 m2repository 이름 앞에 https://dl-ssl.google.com/android/repository/ 를 추가할 수 있습니다.If the m2repository archive is not shown in this table, you can create the download URL by prepending https://dl-ssl.google.com/android/repository/ to the name of the m2repository to download. 예를 들어 https://dl-ssl.google.com/android/repository/android\_m2repository\_r10.z 를 사용 하 여 android_ m2repository_ r10를 다운로드 합니다.For example, use https://dl-ssl.google.com/android/repository/android\_m2repository\_r10.z to download android_m2repository_r10.zip.

  2. 위의 표에 나와 있는 것 처럼 다운로드 URL의 해당 MD5 해시에 파일 이름을 바꿉니다.Rename the file to the corresponding MD5 hash of the download URL as shown in the above table. 예를 들어 android_m2repository_r25를 다운로드 한 경우 이름을 0B3F1796C97C707339FB13AE8507AF50로 바꿉니다.For example, if you downloaded android_m2repository_r25.zip, rename it to 0B3F1796C97C707339FB13AE8507AF50.zip. 다운로드 한 파일의 다운로드 URL에 대 한 MD5 해시가 표에 표시 되지 않는 경우 온라인 md5 생성기 를 사용 하 여 URL을 md5 해시 문자열로 변환할 수 있습니다.If the MD5 hash for the download URL of the downloaded file is not shown in the table, you can use an online MD5 generator to convert the URL to an MD5 hash string.

  3. Xamarin zips 폴더에 파일을 복사 합니다.Copy the file to the Xamarin zips folder:

    • Windows에서이 폴더는 C:\Users\username\AppData\\Local Xamarin\zips에 있습니다.On Windows, this folder is located at C:\Users\username\AppData\Local\Xamarin\zips.

    • Mac OS X에서이 폴더는 /사용자/사용자 이름/.local/share/Xamarin/zips에 있습니다.On Mac OS X, this folder is located at /Users/username/.local/share/Xamarin/zips.

    예를 들어 다음 스크린샷은 android_m2repository_r16 를 다운로드 하 고 Windows에서 다운로드 URL의 MD5 해시로 이름을 바꿀 때의 결과를 보여 줍니다.For example, the following screenshot illustrates the result when android_m2repository_r16.zip is downloaded and renamed to the MD5 hash of its download URL on Windows:

    0595E577D19D31708195A83087881EE6로 이름이 변경 되는 r16 리포지토리의 예입니다.Example of the r16.zip repository being renamed to 0595E577D19D31708195A83087881EE6.zip

이 절차를 수행 해도 빌드 오류가 해결 되지 않으면 android_m2repository_r_nn_ 파일을 수동으로 다운로드 하 고 압축을 풀고 압축을 푼 후 다음 섹션에 설명 된 대로 해당 콘텐츠를 설치 해야 합니다.If this procedure does not resolve the build error, you must manually download the android_m2repository_r_nn_.zip file, unzip it, and install its contents as described in the next section.

수동으로 m2repository 파일 다운로드 및 설치Manually Downloading and Installing m2repository Files

M2repository 오류를 복구 하는 완전히 수동 프로세스는 android_m2repository_r_nn_ 파일 (웹 브라우저 사용)을 다운로드 하 고 압축을 푼 다음 지원 라이브러리 디렉터리에 콘텐츠를 복사 하는 것입니다. 컴퓨터에 있습니다.The fully manual process for recovering from m2repository errors entails downloading the android_m2repository_r_nn_.zip file (using a web browser), unzipping it, and copying its contents to the support library directory on your computer. 다음 예제에서는이 오류 메시지를 복구 합니다.In the following example, we'll recover from this error message:

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.

다음 단계를 사용 하 여 m2repository 를 다운로드 하 고 해당 콘텐츠를 설치 합니다.Use the following steps to download m2repository and install its contents:

  1. 오류 메시지에 해당 하는 라이브러리 폴더의 내용을 삭제 합니다.Delete the contents of the library folder corresponding to the error message. 예를 들어 위의 오류 메시지에서 C:\Users\사용자 이름\AppData\Local\Xamarin\Android. 지원 v4의내용을삭제합니다.23.1.1.0\ .For example, in the above error message you would delete the contents of C:\Users\username\AppData\Local\Xamarin\Android.Support.v4\23.1.1.0. 앞에서 설명한 대로이 디렉터리의 전체 내용을 삭제 해야 합니다.As described earlier, you must delete the entire contents of this directory:

    23.1.1.0 폴더에서 content, embedded 및 android_m2repository 폴더를 삭제Deleting content, embedded, and android_m2repository folders from the 23.1.1.0 folder

  2. Google에서 오류 메시지에 해당 하는 android_m2repository_r_nn_ 파일을 다운로드 합니다 (링크는 이전 섹션의 표 참조).Download the android_m2repository_r_nn_.zip file from Google that corresponds to the error message (see the table in the previous section for links).

  3. .zip 아카이브를 모든 위치 (예: 바탕 화면)로 추출 합니다.Extract this .zip archive to any location (such as the Desktop). .Zip 보관 파일의 이름에 해당 하는 디렉터리를 만들어야 합니다 .This should create a directory that corresponds to the name of the .zip archive. 이 디렉터리 내에서 m2repository라는 하위 디렉터리를 찾아야 합니다.Within this directory, you should find a subdirectory called m2repository:

    압축을 푼 zip 보관 위치에 있는m2repository 폴더m2repository folder found in extracted zip archive

  4. 1 단계에서 제거한 버전 관리 라이브러리 디렉터리에서 콘텐츠포함 된 하위 디렉터리를 다시 만듭니다.In the versioned library directory that you purged in step 1, re-create the content and embedded subdirectories. 예를 들어 다음 스크린샷은 android_m2repository_r2523.1.1.0 폴더에 생성 되는 콘텐츠포함 된 하위 디렉터리를 보여 줍니다.For example, the following screenshot illustrates content and embedded subdirectories being created in the 23.1.1.0 folder for android_m2repository_r25.zip:

    23.1.1.0 폴더에 콘텐츠 및 포함 된 폴더 만들기Create content and embedded folders in the 23.1.1.0 folder

  5. 압축을 푼 .zip 에서 이전 단계에서 만든 콘텐츠 디렉터리로 m2repository 을 복사 합니다.Copy m2repository from the extracted .zip into the content directory that you created in the previous step:

    23.1.1.0/content 폴더로 복사 된 m2repository의스크린샷Screenshot of m2repository copied to 23.1.1.0/content folder

  6. 압축을 푼 .zip 디렉터리에서 m2repository\com\android\지원\지원-v4 로 이동 하 고 위에서 만든 버전 번호가 해당 하는 폴더 (이 예제에서는 23.1.1)를 엽니다.In the extracted .zip directory, browse to m2repository\com\android\support\support-v4 and open the folder corresponding the version number created above (in this example, 23.1.1):

    지원-v4/23.1.1 폴더에 포함 된 파일을 나열 하는 예제Example listing of files contained in the support-v4/23.1.1 folder

  7. 이 폴더의 모든 파일을 4 단계에서 만든 포함 된 디렉터리에 복사 합니다.Copy all of the files in this folder to the embedded directory created in step 4:

    23.1.1.0/embedded 폴더에 복사 된 파일의 예Example of files copied to the 23.1.1.0/embedded folder

  8. 모든 파일이 복사 되었는지 확인 합니다.Verify that all files are copied over. 이제 포함 된 디렉터리에 jar, . aar. e m m과 같은 파일이 포함 됩니다.The embedded directory should now contain files such as .jar, .aar, and .pom.

  9. Aar 파일의 콘텐츠를 포함 된 디렉터리에 압축을 풉니다.Unzip the contents of any extracted .aar files to the embedded directory. Windows에서는 .zip 확장명을 aar 파일에 추가 하 고 열고 해당 내용을 포함 된 디렉터리에 복사 합니다.On Windows, append a .zip extension to the .aar file, open it, and copy the contents to the embedded directory. MacOS에서 터미널의 압축 풀기 명령을 사용 하 여 aar 파일의 압축을 풉니다 (예: aar 압축 풀기).On macOS, unzip the .aar file by using the unzip command in the Terminal (for example, unzip file.aar).

이제 누락 된 구성 요소를 수동으로 설치 하 고 프로젝트를 오류 없이 빌드해야 합니다.At this point, you have manually installed the missing components and your project should build without errors. 그렇지 않은 경우 오류 메시지의 버전에 해당 하는 m2repository 보관 버전 을 다운로드 했는지 확인 하 고 위의 단계에 설명 된 대로 올바른 위치에 해당 콘텐츠를 설치 했는지 확인 합니다.If not, verify that you have downloaded the m2repository .zip archive version that corresponds exactly to the version in the error message, and verify that you have installed its contents in the correct locations as described in the above steps.

요약Summary

이 문서에서는 종속성 라이브러리의 자동 다운로드 및 설치 중에 발생 하는 일반적인 오류에서 복구 하는 방법을 설명 했습니다.This article explained how to recover from common errors that can take place during the automatic download and installation of dependency libraries. 문제 라이브러리를 삭제 하 고 라이브러리를 다시 다운로드 하 고 다시 설치 하는 방법으로 프로젝트를 다시 빌드하는 방법에 대해 설명 했습니다.It described how to delete the problematic library and rebuild the project as a way to re-download and re-install the library. 라이브러리를 다운로드 하 여 zips 폴더에 설치 하는 방법을 설명 했습니다.It described how to download the library and install it in the zips folder. 또한 자동으로 해결할 수 없는 문제를 해결 하는 방법으로 필요한 파일을 수동으로 다운로드 하 여 설치 하는 절차를 추가로 설명 했습니다.It also described a more involved procedure for manually downloading and installing the necessary files as a way to work around issues that cannot be resolved via automatic means.