libs 폴더의 jar에 javadoc 또는 소스를 첨부하는 방법은 무엇입니까?


254

Eclipse 용 ADT r17 플러그인의 새 버전은 JAR 종속성을 자동으로 설정하는 기능을 추가했습니다. / libs 폴더의 모든 .jar 파일이 빌드 구성에 추가되었습니다. 불행히도 Android Dependencies 클래스 경로 컨테이너는 수정할 수 없습니다.

수정 불가능한 안드로이드 의존성 클래스 경로

javadoc 및 소스를 자동으로 삽입 된 .jar (/ libs 폴더에서)에 어떻게 첨부 할 수 있습니까?


귀하의 질문에 대한 답변이 아닌 것 같습니다. Mark의 대답은 해결책이 아니라고 요청한 내용을 정확하게 알려줍니다. auto-libs를 통해 javadoc과 소스를 어떻게 첨부 할 수 있습니까?
pjv 2016 년

2
이 버그 code.google.com/p/android/issues/detail?id=27490#c21에 문제가 있습니다 . 의견 21에 따르면 ADT r20에서 소스 / javadoc 첨부는 표준 java .properties 파일 (foo.jar-> foo.jar.properties)을 사용하여 소스 폴더 (또는 아카이브)에 대한 상대 또는 절대 경로를 편집 할 수 있으며 / 또는 javadoc에 대한 상대 또는 절대 경로.
Sergii Pechenizkyi 2016 년

답변:


401

질문에 대답하는 가장 좋은 방법은 Xavier , plastiv , VinceFRChristopher 의 답변을 요약하는 것입니다 .

단계별 가이드

링크하기 위해 소스와 javadoc는 자동으로 이클립스에 의해 연결되는의 .jar 라이브러리는 다음을 수행해야합니다 :

  1. 라이브러리 .jar 파일을 libs 폴더에 배치하고 연관된 소스 .jar 및 doc .jar 파일을 별도의 서브 폴더 (예 : libs / srclibs / docs) 에 두십시오 . 원하는 경우 srcdocs 이외의 이름을 사용할 수 있지만 .jar 파일이 libs 폴더에 직접 있지 않아야 합니다.
  2. 실제 라이브러리 .jar의 정확한 이름으로 libs 폴더에 .properties파일을 작성 하십시오 (예 참조). .jar 부분 을 유지하십시오 .
  3. .properties파일 에서 소스 및 javadoc .jar에 대한 상대 경로를 지정 하십시오.
  4. 닫기 및 Eclipse 프로젝트를 다시 열어! 선택적으로을 눌러 프로젝트를 새로 고칩니다 F5.
  5. 소스 코드에서 링크 된 라이브러리의 오브젝트를 선택하십시오.
  6. Eclipse에서 Javadoc보기를 열어 문서를 확인하십시오 (스크린 샷 참조).
  7. F3선택한 객체 의 소스 코드 선언 (기본 바로 가기 :)을 엽니 다 .


이 예에서는 Gson 라이브러리 를 사용합니다 .

libs 폴더의 디렉토리 구조 :

libs
├── docs
   └── gson-2.2.2-javadoc.jar
├── gson-2.2.2.jar
├── gson-2.2.2.jar.properties
└── src
    └── gson-2.2.2-sources.jar

gson-2.2.2.jar.properties의 내용

src=src/gson-2.2.2-sources.jar
doc=docs/gson-2.2.2-javadoc.jar


추가 정보

물론 javadoc 및 sources .jar을 다른 폴더로 이동하고 상대 경로를 지정할 수 있습니다. 그것은 당신에게 달려 있습니다. 소스 및 javadoc jar를 lib 폴더에 직접 배치하는 것이 가능하지만 문서 및 소스 코드가 애플리케이션에 포함 되므로 권장하지 않습니다 .


Eclipse JavaDoc 패널의 스크린 샷 :

Eclipse의 JavaDoc보기

Android 4.2.2에서 Gson을 사용하는 Eclipse 프로젝트의 스크린 샷 :

이클립스 테스트 프로젝트 스크린 샷


압축이 풀린 javadoc 참조

패킹 된 .jar것이 아니라 단순히 파일 및 폴더 로 제공되는 javadoc을 주석에서 안드로이드 개발자가 요청한 경우 다음을 수행하십시오.

  1. 라이브러리 .jarlibs/폴더에 배치
  2. 다음 내용으로 yourlibraryname.jar.properties파일을 작성 하십시오 (를 잊지 마십시오.jar ).

     doc=docs
  3. 폴더에 javadocs 폴더를 추가하십시오 libs/.

다음과 같은 폴더 구조가 나타납니다.

├── docs
   ├── allclasses-frame.html
   ├── allclasses-noframe.html
   ├── com
      └── google
          └── ads
              ├── Ad.html
                 ....
              └── package-tree.html
      ...
   └── stylesheet.css
├── GoogleAdMobAdsSdk-6.4.1.jar
└── GoogleAdMobAdsSdk-6.4.1.jar.properties

위에서 언급 한대로 Eclipse 프로젝트를 닫았다다시 여는 것을 잊지 마십시오 ! 다음은 GoogleAdMobAds Android 라이브러리를 참조하는 실제 예제 프로젝트의 스크린 샷입니다 .

GoogleAdMobAds Android 라이브러리 Eclipse 프로젝트


7
Ahhh, 나에게 필요한 Eclipse 프로젝트가 닫히고 다시 열립니다. (나는 그 전에 행운이없이 여러 번 상쾌하고 청소했다.)
Steve Haley

4
감사합니다 @JJD. 작동하기 전에 Eclipse를 다시 시작해야했습니다.
javajavajavajavajava

26
참고 : 당신은 정말 해야한다 , 그렇지 않으면 이러한 JAR 파일이 APK로 처리 할 것입니다, 하위 디렉토리, 예를 들어 "./libs/docs을"으로 자바 독과 소스 JAR 파일을 넣어! 또한 중복 HTML 파일을 찾을 때 APK 빌드가 실패하므로 여러 라이브러리에 Javadoc을 포함 할 수 없습니다.
Christopher Orr

5
.properties 파일에서 원격 javadoc을 참조 할 수 있습니까? doc = community.versant.com/documentation/reference/db4o-8.0/java/api
Matthias

9
소스 코드가 아닌 Javadoc 만 링크하려는 경우 분명히 작동하지 않습니다 .7zip이있는 Javadoc jar를 내 문서의 폴더로 추출한 다음 속성 파일이 Javadoc 색인이있는 폴더를 가리켜 야했습니다 .html 직접 doc = C : \\ Users \\ johny \\ workspacenewfb \\ robotium-solo-4.0-javadoc
mbwasi

25

Windows에서는 특성 파일의 doc 및 src 경로에 대한 참조를 위해 백 슬래시를 이스케이프해야합니다. 예를 들어 android-support-v4.jar의 경우 특성 파일 컨텐츠는 다음과 같습니다.

doc=C:\\Program Files (x86)\\Android\\android-sdk\\extras\\android\\support\\v4\\docs
src=C:\\Program Files (x86)\\Android\\android-sdk\\extras\\android\\support\\v4\\src

1
와우 당신의 대답이 내 문제를 해결 와우, 하나를 넣어하지만 우리는 \\ .thanks 너무 많이 넣어야합니다
Arash

17

답변은 http://code.google.com/p/android/issues/detail?id=27490#c21 에서 가져옵니다 .

libs 폴더에는 다음이 있어야합니다.

doc(folder)
    foo_doc(folder)
        index.html
        ...
        ...
foo.jar
foo.jar.properties

그리고 당신의 foo.jar.properties, 그냥 넣어doc=./doc/foo_doc

어쩌면 프로젝트를 새로 고치고 정리하고 닫고 다시 열어야 할 수도 있습니다.

그것은 나를 위해 작동합니다!


zip 파일에 문서가있는 경우이 방법이 많이 있습니다. 감사합니다! 엄지 손가락
Akhil Jain

10

나는 위의 모든 것을 시도했지만 그들 중 누구도 나를 위해 일하지 않았다. 나는 항상 작동하는 방법을 알아 냈습니다. 기본적으로 범인은 ADT가 "libs"폴더를 처리하는 방식이므로 "libs"폴더 사용을 종료합니다. 대신 "라이브러리"폴더를 만들어서 사용했습니다.

ADT가 나중에 "libs"폴더를 처리하는 방식을 변경하는 방식을 변경하더라도 다음과 같은 작업을 수행 할 수 있으며 항상 작동합니다.

  1. "라이브러리"폴더를 만듭니다.
  2. 각 라이브러리마다 그 아래에 하위 폴더를 만듭니다.
  3. 각 라이브러리의 모든 파일을 적절한 폴더 (Java jar 파일, 소스 jar 파일, javadoc jar 파일 등)에 넣으십시오.
  4. "라이브러리" Add Jars...폴더의 라이브러리 하위 폴더에서 jar를 추가하려면 단추를 클릭하여 Java 빌드 경로의 "라이브러리"탭에서 각 프로젝트에 대한 Java jar 파일 을 추가하십시오.
  5. "라이브러리"탭에서 프로젝트를 열고 원하는 항목을 선택한 다음 Edit...버튼을 클릭 하여 "라이브러리"폴더의 라이브러리 하위 폴더에서 소스 / javadoc을 추가 하여 소스 / javadoc을 각 프로젝트에 연결하십시오 .
  6. Java 빌드 경로의 "주문 및 내보내기"탭에서 각 프로젝트의 확인란을 선택하십시오.
  7. 모든 라이브러리가 이동되었는지 확인한 후 "libs"폴더를 삭제하십시오.

위의 절차를 따르면 프로젝트는 다음과 같은 폴더를 갖게됩니다.

여기에 이미지 설명을 입력하십시오

Java 빌드 경로는 다음과 같습니다.

여기에 이미지 설명을 입력하십시오

주문 및 내보내기에서 라이브러리가 선택됩니다.

여기에 이미지 설명을 입력하십시오


5

지금은 Javadoc으로 이동하려는 라이브러리를 이동하십시오 lib. 그런 다음 해당 라이브러리를 Build Path추가하고 Javadoc을 추가하십시오.

안드로이드 문제 에서이 의견 을 확인하십시오 .


순서를 확인하고 라이브러리를 내보내기로 설정하는 것을 잊지 마십시오 Build Path.
Carlos Sobrinho

4

ADT 22에서 commons-io-2.4.jar 및 android-support-v4.jar에 대한 Javadoc에 액세스 할 수 없습니다.

이것이 내가 고친 방법입니다.

  1. 전제 조건 : 두 라이브러리 모두 "참조 라이브러리"에 나열되어 있습니다.

  2. commons-io-2.4.jar를 마우스 오른쪽 버튼으로 클릭하고 속성을 선택하십시오. 이 창이 나타납니다.

여기에 이미지 설명을 입력하십시오

commons-io-2.4.jar는 commons-io-2.4-javadoc.jar와 번들로 제공되므로 아카이브 외부 파일 경로에 Javadoc을 지정했습니다.

지원 라이브러리에 대해서도 동일한 작업을 수행했습니다. android-support-v4.jar을 마우스 오른쪽 버튼으로 클릭하고 속성을 선택하십시오. 이 화면이 나타납니다 :

여기에 이미지 설명을 입력하십시오

이번에는 소스 디렉토리의 경로를 지정했습니다.


이것은 javadoc 및 / 또는 src를 라이브러리에 첨부하는 가장 쉽고 직접적인 방법입니다. 감사! 덧붙여서 javadoc이나 src는 Referenced Library에 없어도됩니다.
실버

3

SDK Tools 및 ADT 개정 17로 업그레이드 할 때 commons-io-2.0.1.jar에 대한 라이브러리 참조가 손상되었습니다.

문제를 해결하기 위해 프로젝트-> 속성-> Java 빌드 경로를 사용하고 라이브러리 탭을 선택했습니다. commons-io-2.0.1.jar에 대한 참조를 삭제 한 다음 Jar 추가를 사용하여 commons-io-2.0.1.jar을 프로젝트에 다시 추가했습니다. 그런 다음 라이브러리 이름 옆의 '>'화살표를 클릭하여 라이브러리 참조를 펼치고 편집 단추를 사용하여 소스 첨부 파일과 Javadoc 위치를 설정하십시오.

담당자가 충분하지 않아 이미지를 게시 할 수 없습니다 (제발 ...).


나를 위해 일하지 않았다. jar 파일을 프로젝트에서 어디에 보관합니까? libs 폴더에 내 것이 있습니다.
Daniel Ryan

마침내 누군가 실제로 작동하는 지시를 내 렸습니다! 고마워요 ".properties"파일을 포함하여 앞에서 언급 한 방법 중 어느 것도 나에게 도움이되지 않았지만 대화 상자 화면에서 라이브러리를 외부 JAR로 추가하면 작업이 수행되었습니다.
AlxDroidDev

1

움직이는 대상으로 보이지만 많은 곳에서 비트와 조각을 수집 한 후 (필요한 모든 세부 사항을 설명하지 못했거나 시스템이 약간 변경되었을 수있는이 질문에 대한 답변을 포함하여) 적어도 현재로서는 (2013 년 8 월 28 일) 솔루션.

  • 프로젝트 내부가 아닌 곳에 javadocs의 폴더를여십시오 .
  • javadoc을 압축 해제하여 각각 자체 폴더에 넣으십시오 .
  • lib폴더 안에 xxx.jar.propertiesjavadoc을 연관시키려는 각 lib 에 대한 파일을 추가하십시오 .
  • 해당 특성 파일 에서 적절한 javadoc의 압축을 푼 폴더 를 참조하십시오 (Windows의 경우 백 슬래시를 이스케이프 처리).

doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices

  • Eclipse에서 프로젝트를 닫았다가 다시여십시오 (새로 고치기로는 충분하지 않습니다). 적절한 클래스 위로 마우스를 가져 가면 툴팁이 표시됩니다.

javadoc의 압축을 풀지 않고 폴더 대신 파일을 참조하는 등의 단계를 지키지 않으면 실패하는 것 같습니다.


1

나는이 질문이 다소 오래되었다는 것을 알고 있지만 어제 같은 문제에 직면했을 때 위에 게시 된 솔루션이 너무 성가신 경우 프로젝트의 .classpath 파일에 소스 경로 정의를 쉽게 추가 할 수 있음을 알았습니다. 그러면 Eclipse가이를 적용하여 소스를 찾아 볼 수 있습니다.

클래스 패스 입력 전 :

<classpathentry kind="lib" path="[PATH_TO_MY_JAR]"/>

소스에 경로를 추가 한 후

<classpathentry kind="lib" path="[PATH_TO_MY_JAR]" sourcepath="[PATH_TO_MY_SOURCE_JAR]"/>

도움이 되었기를 바랍니다


0

ADT 플러그인 만 업데이트하면됩니다. 그것은 나를 위해 일했다!!

  1. Eclipse를 시작한 다음 도움말> 새 소프트웨어 설치를 선택하십시오.
  2. 오른쪽 상단에서 추가를 클릭하십시오.
  3. 표시되는 저장소 추가 대화 상자에서 이름에 "ADT 플러그인"을 입력하고 위치에 다음 URL을 입력하십시오. https://dl-ssl.google.com/android/eclipse/ 참고 : Android 개발자 도구 업데이트 사이트에는 안전한 연결. 입력 한 업데이트 사이트 URL이 HTTPS로 시작하는지 확인하십시오.
  4. 확인을 클릭하십시오. 사용 가능한 소프트웨어 대화 상자에서 개발자 도구 옆에있는 확인란을 선택하고 다음을 클릭하십시오.
  5. 다음 창에서 다운로드 할 도구 목록이 표시됩니다. 다음을 클릭하십시오.
  6. 라이센스 계약을 읽고 동의 한 후 완료를 클릭하십시오.
  7. 소프트웨어의 진위 또는 유효성을 확인할 수 없다는 보안 경고가 표시되면 확인을 클릭하십시오.
  8. 설치가 완료되면 Eclipse를 다시 시작하십시오.

희망이 도움이됩니다!


0

주어진 jar에 대해 코딩하는 동안 툴팁에 대한 Javadoc 도움말을 보려면 다음을 수행하십시오. 프로젝트> 특성> Java 빌드 경로> 라이브러리 탭을 마우스 오른쪽 단추로 클릭하십시오. 항아리 옆에있는 화살표를 클릭하여 확장합니다.

소스 첨부 는 실제 jar의 위치를 ​​가리켜 야합니다 (아마 java 폴더에 있음).

Javadoc 위치 : URL과 아카이브 중에서 두 가지를 선택할 수 있습니다. 이 jar에 대한 javadoc이 index.html을 포함하는 폴더 형태 인 경우 첫 번째 레벨에서 파일을 'Javadoc URL'을 선택하고 해당 폴더를 가리 킵니다. javadoc이 jar에있는 경우 'Javadoc in archive'를 선택하고 jar을 가리 킵니다. Javadoc 정보로 툴팁을 업데이트하려면 작업 공간을 다시 시작하고 프로젝트를 닫았다가 다시 여는 것을 잊지 마십시오.

이것이 매우 간단한 작업이어야한다고 생각하는 것에 대한 간단한 답변을 제공하는 데 도움이되기를 바랍니다.


0

내 해결책 :

"Java Source Attacher Feature"라는 Eclipse 플러그인을 다운로드하십시오.

나중에 jar를 선택하고이 플러그인을 사용하여 소스 코드를 첨부하십시오. jar 파일을 클릭하여 마우스 오른쪽 버튼으로 선택한 다음 "attach java source"를 선택하십시오.

소스 코드가 있으면 자동으로 javadoc이됩니다.

이제 클래스에서 F2를 사용하여 연관된 javadoc을 볼 수 있습니다.

즐겨

당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.