카드 실행 및 디버그

카드는 앱이 아니므로 다른 메커니즘을 사용하여 배포되고 실행됩니다. 기기에 개발자 옵션이 사용 설정되어 있으면 (에뮬레이터에는 이러한 기능이 기본적으로 사용 설정됨) 카드 개발을 지원하는 추가 기능을 Android 스튜디오와 adb에서 모두 사용할 수 있습니다.

타일 배포

카드를 배포하려면 앱 빌드 및 실행에 설명된 대로 Android 스튜디오를 사용하여 실제 기기나 에뮬레이터에 앱을 설치합니다. 그런 다음 일반 사용자와 동일한 단계에 따라 수동으로 카드 캐러셀에 카드를 추가합니다.

개발 중에는 Android 스튜디오의 'Wear OS 카드' 실행/디버그 구성 기능을 사용하면 더 쉽고 빠르게 작업할 수 있습니다. 이 방법은 타일을 자동으로 배포하고 활성화하므로 추가 수동 단계 없이 즉시 상호작용할 수 있습니다.

구성 자동 생성

카드를 배포하고 실행하는 가장 쉬운 방법은 가로등에서 '서비스 실행' 아이콘을 사용하는 것입니다. 실행 구성이 아직 없는 경우 자동으로 생성됩니다. 자세한 내용은 Wear OS 실행/디버그 구성을 참고하세요.

여백의 '▷'를 가리키는 빨간색 화살표가 있는 스크린샷
여백에서 '▷'를 클릭합니다.
실행 구성 드롭다운을 가리키는 빨간색 화살표와 빨간색으로 윤곽선이 표시된 'TestTileService' 구성 옵션을 보여주는 스크린샷
'실행 구성'이 자동으로 생성됩니다.

수동으로 구성 만들기

자동 구성이 작동하지 않거나 결과를 더 세부적으로 제어하려면 다음 안내를 참고하세요. 스크린샷은 Android 스튜디오 Meerkat (2024.3.1)의 스크린샷입니다.

  1. 제목 표시줄에서 '⋮' ('햄버거') 옵션을 선택합니다.

    제목 표시줄의 '⋮' ('햄버거') 옵션을 빨간색 화살표로 가리키는 스크린샷

  2. '수정…'을 선택합니다.

    '수정…'은 드롭다운 목록의 구성 섹션에 있는 첫 번째 옵션입니다.

  3. '+'를 선택하여 표시되는 대화상자에 구성을 추가합니다.

    '+'를 가리키는 빨간색 화살표가 있는 스크린샷

  4. 새 구성 유형으로 'Wear OS Tile'을 선택합니다.

    'Wear OS Tile' 구성 옵션을 가리키는 빨간색 화살표가 있는 스크린샷

  5. 구성의 이름을 입력하고 적절한 모듈과 카드를 선택합니다.

    대화상자 창의 영역을 가리키는 빨간색 화살표 3개가 있는 스크린샷

  6. '확인'을 탭합니다. 구성이 제목 표시줄에 표시됩니다. '▷'('실행') 버튼을 탭하면 타일이 배포되고 활성화됩니다.

Android 스튜디오에서 카드 미리보기

Android 스튜디오 Koala 기능 출시부터 Wear OS 앱 카드의 스냅샷을 볼 수 있습니다. 이 패널은 기기의 디스플레이 크기에 따라 콘텐츠가 달라지거나 스포츠 경기가 하프타임에 도달하는 등 조건에 따라 카드의 모양이 변경되는 경우에 특히 유용합니다.

미리보기 패널의 그룹 이름이 미리보기 주석에 지정된 그룹 이름과 일치함
Android 스튜디오의 카드 미리보기 패널

종속 항목 추가

앱의 build.gradle.kts 또는 build.gradle 파일에 다음 종속 항목을 포함합니다.

dependencies {
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.5.0-alpha10")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.5.0-alpha10")
    implementation("androidx.wear:wear-tooling-preview:1.0.0")
}

카드 미리보기 구성

다양한 Wear OS 디스플레이 크기에서 카드의 모양을 미리 보려면 @Preview 주석을 추가하고 device 매개변수를 전달합니다. 이 @Preview 주석은 컴포저블 미리보기에 사용하는 패키지와 다른 패키지에 있습니다.

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
@Preview(device = WearDevices.LARGE_ROUND)
fun tilePreview(context: Context) = TilePreviewData(
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

리소스 추가 및 등록

카드에서 Android 리소스를 사용하는 경우 다음 코드 스니펫과 같이 TilePreviewData의 onTileResourceRequest 매개변수 내에 리소스를 등록해야 합니다.

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithResources(context: Context) = TilePreviewData(
    onTileResourceRequest = { request ->
        Resources.Builder()
            .setVersion(myResourcesVersion)
            .addIdToImageMapping(
                    myImageId, getImageById(R.drawable.myDrawableImageId))
            .build()
    },
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

fun getImageById(
    @DrawableRes id: Int,
): ImageResource =
    ImageResource.Builder()
        .setAndroidResourceByResId(
            AndroidImageResourceByResId.Builder()
                .setResourceId(id)
                .build(),
        )
        .build()

플랫폼 데이터 소스의 특정 값 표시

카드가 심박수, 칼로리, 거리, 걸음 수와 같은 플랫폼 데이터를 사용하는 경우 카드에 기본값이 표시됩니다.

특정 값을 표시하려면 다음 코드 스니펫과 같이 TilePreviewData 객체를 만들 때 platformDataValues 매개변수를 설정합니다.

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithPlatformOverride(context: Context) = TilePreviewData(
    platformDataValues = PlatformDataValues.of(
        PlatformHealthSources.Keys.HEART_RATE_BPM,
        DynamicDataBuilders.DynamicDataValue.fromFloat(160f)
    ),
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

adb를 사용하여 카드 조작

adb는 개발 중에 카드를 프로그래매틱 방식으로 설치, 삭제, 활성화하는 데 사용할 수 있습니다.

다음 명령어에서 ComponentName는 패키지 이름과 패키지 내의 클래스로 구성된 문자열입니다(예: com.example.wear.tiles/com.example.wear.tiles.PreviewTileService).

add-tile

COMPONENT_NAME에서 제공하는 카드를 추가하고 색인을 반환합니다.

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation add-tile --ecn component [COMPONENT_NAME]

출력 예:

Broadcast completed: result=1, data="Index=[0]"

캐러셀에 이미 타일이 있는 경우 타일이 삭제되고 동일한 위치에 다시 삽입됩니다. 그렇지 않으면 Index[0]에 삽입됩니다. 또한 캐러셀이 최대 용량에 도달하면 새 타일을 위한 공간을 확보하기 위해 마지막 타일이 삭제됩니다.

show-tile

색인 TILE_INDEX에서 타일을 활성화합니다.

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SYSUI --es operation show-tile --ei index [TILE_INDEX]

출력 예:

Broadcast completed: result=1

remove-tile

캐러셀에서 COMPONENT_NAME와 연결된 모든 카드 인스턴스를 삭제합니다.

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation remove-tile --ecn component [COMPONENT_NAME]

출력 예:

result=1, data="Tile(s) removed."

반환 값

  • result=0: Wear OS 버전이 너무 오래되었거나 디버그 프로세스가 실행되지 않아 이 명령어에 응답한 broadcast receiver가 없습니다.
  • result=1: 성공입니다.
  • result>1: 오류입니다.