Javadoc을 사용하여 매개 변수 이름 지정

  • 아티클

Important

현재 Xamarin 플랫폼에서 사용자 지정 바인딩 사용을 조사하고 있습니다. 설문 조사에 참여하여 향후 개발 작업에 대해 알려 주시기 바랍니다.

이 문서에서는 Java 프로젝트에서 생성된 Javadoc을 사용하여 Java 바인딩 프로젝트에서 매개 변수 이름을 복구하는 방법을 설명합니다.

개요

기존 Java 라이브러리를 바인딩하는 경우 바인딩된 API에 대한 일부 메타데이터가 손실됩니다. 특히 메서드에 대한 매개 변수 이름이 손실될 수 있습니다. 매개 변수 이름은 등p1으로 p0표시됩니다. 이는 Java 파일이 Java .class 소스 코드에서 사용된 매개 변수 이름을 유지하지 않기 때문입니다.

원본 라이브러리에서 Javadoc HTML에 대한 액세스 권한이 있는 경우 Xamarin.Android Java 바인딩 프로젝트가 매개 변수 이름을 제공할 수 있습니다.

Javadoc HTML을 Java 바인딩 프로젝트에 통합

Javadoc HTML을 Java 바인딩 프로젝트에 통합하는 작업은 다음 단계로 구성되는 수동 프로세스입니다.

  1. 라이브러리에 대한 Javadoc 다운로드
  2. .csproj 파일을 편집하고 <JavaDocPaths> 속성을 추가합니다.
  3. 프로젝트 정리 및 다시 빌드

이 작업을 완료한 후에는 Java 바인딩 프로젝트에 의해 바인딩된 API에 원래 Java 매개 변수 이름이 있어야 합니다.

참고 항목

JavaDoc 출력에는 상당한 차이가 있습니다. .JAR 바인딩 도구 체인은 가능한 모든 단일 순열을 지원하지 않으므로 일부 매개 변수의 이름이 제대로 지정되지 않을 수 있습니다.

요약

이 문서에서는 Java 바인딩 프로젝트에서 Javadoc를 사용하여 바인딩된 API에 대해 의미 있는 매개 변수 이름을 제공하는 방법을 설명했습니다.