Wear OS 5 Watch Face Format: Deklaratif Watch Face Geliştirme

# Wear OS 5 Watch Face Format: Deklaratif Watch Face Geliştirme

Wear OS 5 (2024 release, Pixel Watch 3 + Galaxy Watch 7 ile popülerleşti) Watch Face geliştirmeyi tamamen yeniden tanımladı. Watch Face Format (WFF) — XML-based declarative approach, eski Canvas API'sinin %50 daha az battery tüketimi, hızlı iteration, cross-device compatibility. Bu yazı WFF sistemini, complications entegrasyonunu, health sensors kullanımını ve Samsung + Google ecosystem uyumunu kapsar.

💡 Pro Tip: WFF ile yapılan watch face Canvas API'den %50 daha az battery tüketir — saat gün boyu takılır, bu battery farkı ciddi.

İçindekiler

• Watch Face Format Nedir
• XML Structure
• Complications
• Time-aware Expressions
• Device State (Battery, Charging)
• Health Sensors
• Styles ve Variations
• Publishing ve Distribution

Watch Face Format Nedir

2 yaklaşım:

• Canvas-based (eski): Kotlin + Jetpack Compose, her frame render — flexibility max, battery cost yüksek
• WFF (yeni): XML deklaratif, system render eder — limited flexibility, **%50 battery tasarruf**

Samsung 2023'te Galaxy Watch için öneri modu, Google 2024'te Wear OS 5 ile standard yaptı.

XML Structure

1
2
3    
4    
5 
6    
7        
8        
9            
10        
11 
12        
13        
14            
15                          color="#FFFFFF"
16                          fontFamily="OpenSans-Bold"
17                          fontSize="72"/>
18        
19 
20        
21        
22            
23                      color="#CCCCCC"
24                      fontSize="24"/>
25        
26    
27

Preview edit ile anında görünüm — Android Studio Wear OS 5 eklentisi live preview yapar.

Complications

3rd party complication provider'ları (pedometer, weather, calendar):

1
2    slotId="0"
3    x="80" y="80" width="80" height="80"
4    supportedTypes="SHORT_TEXT|ICON|RANGED_VALUE">
5 
6    
7 
8    
9        
10        
11        
12    
13

User Watch app'ten complication'ı provider seçer. Watch face görünüm değişmez, data değişir.

Time-aware Expressions

Dinamik değerler:

1
2
3    
4        centerX="225" centerY="225"
5        width="4" length="200"
6        color="#FF0000">
7        
8            [SECOND] * 6
9        
10    
11
12 
13
14
15    centerX="225" centerY="225" radius="220"
16    thickness="8"
17    progressColor="#4CAF50"
18    backgroundColor="#333333">
19    
20        [HOUR_0_23] / 24.0
21    
22

Expression'lar:

• [SECOND], [MINUTE], [HOUR_0_23]
• [BATTERY_PERCENT]
• [STEP_COUNT]
• [HEART_RATE]
• [NOTIFICATIONS_COUNT]

Device State (Battery, Charging)

1
2
3    centerX="380" centerY="70" radius="30"
4    progressColor="[BATTERY_COLOR]">
5    
6        [BATTERY_PERCENT] / 100.0
7    
8 
9    
10    
11        
12            #FF3333
13            
14                #FFAA33
15                #33FF33
16            
17        
18    
19
20 
21
22
23    
24    
25        [IS_CHARGING]
26    
27

Health Sensors

1
2
3    
4        [HEART_RATE]
5    
6    
7
8 
9
10
11    
12        [STEP_COUNT]
13    
14    
15
16 
17
18
19    
20        [SPO2_PERCENT]
21    
22

Health sensor erişim user permission'a bağlı.

Styles ve Variations

User watch face customization:

1
2    
3        
4        
5        
6    
7 
8    
9        
10        
11        
12    
13 
14    
15

User saat uygulamasından bunları değiştirir.

Publishing ve Distribution

1. Play Console: "Watch Face" uygulama tipinden gönder
2. Build: ./gradlew :wear:bundleRelease
3. Review: Play Store Wear OS review team — teknik + content validation

Wear OS 5 watch face'leri standalone app olarak publish edilir (phone app'ten bağımsız).

1
2    
3    
4        
5            
6        
7 
8        
9            
10                          color="#FFFFFF"
11                          fontFamily="RobotoMono"
12                          fontSize="96"/>
13        
14 
15        
16            
17        
18 
19        
20        
21    
22

Sonuç

Watch Face Format, Wear OS 5'in battery-friendly, kolay geliştirilebilir watch face standart'ı. XML deklaratif yaklaşımı Canvas API'den %50 daha az battery tüketir. Samsung + Google cross-compatibility. Publishing streamlined. Canvas'ın flexibility'sine ihtiyaç yoksa (complex animations, games) — WFF default tercih. Pixel Watch 3, Galaxy Watch 7 ecosystem'inde hızla yaygınlaşıyor.

*İlgili yazılar: Compose 1.7, WorkManager 2.10, Android 15.*