【亲测免费】 Wear OS 示例项目教程

项目的目录结构及介绍

Wear OS 示例项目的目录结构如下：

wear-os-samples/
├── Complications
├── ComposeStarter
├── DataLayer
├── WatchFaceFormat
├── WatchFaceKotlin
├── WearOAuth
├── WearSpeakerSample
├── WearTilesKotlin
├── scripts
├── spotless
├── .editorconfig
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── renovate.json

目录介绍

• Complications: 包含与复杂功能相关的示例代码。
• ComposeStarter: 使用 Jetpack Compose 的入门示例。
• DataLayer: 数据层相关的示例代码。
• WatchFaceFormat: 表盘格式相关的示例代码。
• WatchFaceKotlin: 使用 Kotlin 编写的表盘示例。
• WearOAuth: 展示如何在 Wear OS 应用中进行用户认证的示例。
• WearSpeakerSample: 展示如何在有扬声器的可穿戴设备上进行音频录制和播放的示例。
• WearTilesKotlin: 使用新的 AndroidX 库展示 Tiles 的示例。
• scripts: 包含项目使用的脚本文件。
• spotless: 代码格式化相关的配置文件。
• .editorconfig: 编辑器配置文件。
• .gitignore: Git 忽略文件配置。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• renovate.json: Renovate 配置文件。

项目的启动文件介绍

项目的启动文件通常位于 ComposeStarter 或 WatchFaceKotlin 目录中。以下是 ComposeStarter 目录中的启动文件示例：

// ComposeStarter/MainActivity.kt
package com.example.composestarter

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.tooling.preview.Preview
import com.example.composestarter.ui.theme.ComposeStarterTheme

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            ComposeStarterTheme {
                Surface(color = MaterialTheme.colorScheme.background) {
                    Greeting("Wear OS")
                }
            }
        }
    }
}

@Composable
fun Greeting(name: String) {
    Text(text = "Hello $name!")
}

@Preview(showBackground = true)
@Composable
fun DefaultPreview() {
    ComposeStarterTheme {
        Greeting("Wear OS")
    }
}

启动文件介绍

• MainActivity.kt: 这是应用的主活动文件，负责设置和显示 Jetpack Compose 界面。
• Greeting(name: String): 这是一个简单的 Composable 函数，用于显示欢迎信息。
• DefaultPreview(): 这是一个预览函数，用于在设计时预览 Composable 函数。

项目的配置文件介绍

项目的配置文件主要包括 .editorconfig、.gitignore 和 renovate.json。

.editorconfig

.editorconfig 文件用于统一不同编辑器和 IDE 的代码格式：

# Editor configuration, see https://editorconfig.org
root = true

[*]
charset = utf-8
indent_style = space
indent_size = 4
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true

[*.md]
max_line_length = off
trim_trailing_whitespace = false

.gitignore

.gitignore 文件用于指定 Git 忽略的文件和目录：

# Gradle files
.gradle/
build/

# Local configuration file (sdk path, etc)
local.properties

# Log files
*.log

# Android Studio directories and