구현 테스트

이 문서에서는 매니페스트의 URL부터 완성된 프로덕션 앱에 대한 Google 검색결과까지, 구현을 테스트하는 다양한 방법을 확인할 수 있습니다.

URL 테스트

앱의 매니페스트를 개발할 때 URL을 테스트하는 데 도움이 되는 다양한 도구를 사용할 수 있습니다.

URL에 대한 Lint 검사

앱으로 연결되는 URL을 지원하기 위해 매니페스트를 만들 때 Android 스튜디오 Lint 버전 2.x를 사용하여 인텐트 필터의 구문 오류를 파악합니다. Android 스튜디오가 매니페스트를 지속적으로 자동 스캔하여 매니페스트의 오류를 알려 줍니다.

구문 검사를 수동으로 실행하려면 애플리케이션 메뉴에서 분석 > 코드 조사를 선택하고 오류가 있는지 확인합니다.

  • HTTP URL 구문 경고는 노란색으로 강조표시됩니다.
  • HTTP URL 오류는 빨간색 밑줄로 표시됩니다.
  • 편집기 하단 창에는 매니페스트에서 줄을 빠르게 찾아갈 수 있도록 모든 오류가 표시됩니다.

Lint 검사 구성에 대한 자세한 내용은 Android 스튜디오 Lint 문서Android에서 Lint 구성을 참조하세요.

URL의 앱 활동 실행 확인

아래와 같이 3가지 방법으로 URL이 앱을 올바르게 실행하는지 확인할 수 있습니다.

  • Android 스튜디오에서 URL 테스트
  • Android 디버그 브리지
  • URL QR 코드 테스트 도구

Android 스튜디오에서 URL 테스트

Android 스튜디오 버전 2.x의 딥 링크 테스트 기능을 사용하여 지정된 URL로 앱을 실행할 수 있는지 확인합니다.

  1. Android 스튜디오의 Android 뷰에서 프로젝트를 엽니다.
  2. 프로젝트가 열리면 실행 > 구성 수정을 선택하고 구성 실행/디버그 대화상자에서 URL 테스트 구성을 수정합니다.
  3. Android 애플리케이션 아래에서 테스트할 모듈을 선택합니다.
  4. 일반 탭을 클릭합니다.
  5. 시작 필드에서 URL을 선택합니다.
  6. URL 필드에서 를 클릭하여 정의된 URL 목록에서 선택합니다.
  7. 또는 테스트할 URL(예: http://example.com/gizmos)을 입력합니다.

  8. 확인을 클릭합니다.
  9. 실행 > 앱 실행 또는 앱 디버깅을 선택합니다.
  10. 배포 대상 선택 대화상자가 나타나면 연결된 기기 또는 에뮬레이터를 선택하고 확인을 클릭합니다.
  11. 링크가 정상적이면 기기 또는 에뮬레이터에서 앱이 실행되고 앱에서 지정된 활동이 표시됩니다. 그렇지 않은 경우 실행 창에 오류 메시지가 표시됩니다.

Android 디버그 브리지

링크를 통해 앱이 열리는지 테스트하기 위해 다음과 같이 Android 디버그 브리지를 사용합니다. 여기서 {URL}은 앱 매니페스트에 선언된 HTTP URL을 나타냅니다.

      adb shell am start -a android.intent.action.VIEW -d "{URL}" {package name}
    

HTTP URL 테스트 도구

QR 코드 생성기를 사용하여 형식과 동작이 올바른지 확인합니다. 아래 텍스트 상자에 HTTP URL을 입력하면 Android 바코드 스캐너 앱으로 스캔할 수 있는 QR 코드가 생성됩니다. 이렇게 하면 링크와 함께 브라우저 페이지가 열려야 합니다. 휴대전화에서 링크를 클릭하면 텍스트 상자에 입력한 HTTP URL이 열려야 합니다.

공개 콘텐츠 색인 테스트

다음 도구를 사용하여 URL이 Google 검색결과에 나타나는지 확인합니다.

개인 콘텐츠 색인 생성 테스트

기기의 개인 콘텐츠 색인을 테스트하려면 Google 앱에서 으로 이동하고 개인 콘텐츠에 포함된 항목을 검색합니다.

앱에서 기기별 개인 콘텐츠 색인에 추가하는 모든 Indexable 객체의 목록을 확인하고 검증하려면 Android 스마트폰에서 설정 > Google로 이동하여 개발자 옵션 섹션에서 Firebase 앱 색인 생성을 탭합니다. 이 옵션은 스마트폰이 개발자 모드일 때만 보입니다. 색인 대상 객체의 목록을 검토하고 각 객체를 탭하여 메타데이터가 정확한지 확인합니다.

Gboard 스티커 테스트

Gboard 스티커를 테스트하려면 휴대전화에서 최신 버전의 Gboard를 엽니다. 그런 다음 스티커 팔레트로 이동하여 패널에서 스티커를 확인합니다.

사용자 작업 로그 기록 테스트

다음과 같은 방법으로 앱의 App Indexing API 호출을 확인합니다.

Android 디버그 브리지 사용

Android 디버그 브리지를 사용하여 App Indexing API 호출에서 전송한 데이터를 기록하고 확인합니다.

  1. 로그를 사용 설정합니다.
    작업
    adb shell setprop log.tag.FirebaseUserActions VERBOSE
    색인
    adb shell setprop log.tag.FirebaseAppIndex VERBOSE
  2. 로그를 조회합니다.
    사용자 작업
    adb logcat -v time -s FirebaseUserActions:V
    앱 색인
    adb logcat -v time -s FirebaseAppIndex:V
  3. App Indexing API 호출을 트리거하는 앱 활동을 실행합니다.

그러면 로그에 API 호출이 표시됩니다.

Android Monitor 사용

HTTP URL을 통해 실행된 activity가 App Indexing API에 통합된 경우 Android Monitor를 사용하여 App Indexing API 호출을 검토할 수 있습니다. 로그를 검토하려면 Android Monitor 설정을 다음과 같이 변경합니다.

  1. 로그 수준자세히로 설정합니다.
  2. 검색 필드에 FirebaseUserActions를 입력합니다.
  3. 오른쪽의 필터 드롭다운 목록에서 필터 없음을 선택합니다.
    Android Monitor 설정

앱 색인 생성 로그 항목이 표시되지 않는 경우 다음과 같이 진행합니다.

  • 기기 또는 에뮬레이터에 Google Play 서비스를 설치합니다.
  • 설치된 Google Play 서비스 버전이 build.gradle에 지정된 버전보다 높은지 확인합니다.

자동 완성 테스트

API를 호출하는 페이지에서 검색어 자동 완성이 표시되는지 확인합니다. 이렇게 하려면 앱의 새 빌드에서 API를 호출하는 몇몇 페이지를 방문합니다. 그런 다음 기기에서 Google 앱을 방문하고 앱과 관련된 검색어를 입력합니다. 이때 목록에 앱 아이콘을 표시하며 앱의 해당 페이지로 바로 연결되는 검색결과가 있어야 합니다.

마지막: 검색 실적 향상

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.