WatchFaceRuntimeService

Artifact: androidx.wear.watchface:watchface

Added in 1.2.0

Kotlin |Java

public abstract class WatchFaceRuntimeService extends WatchFaceService

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.service.wallpaper.WallpaperService
				↳	androidx.wear.watchface.WatchFaceService
					↳	androidx.wear.watchface.WatchFaceRuntimeService

Known direct subclasses

ListenableWatchFaceRuntimeService

ListenableWatchFaceRuntimeService

ListenableFuture-based compatibility wrapper around WatchFaceRuntimeService's suspending WatchFaceService.createWatchFace.

WatchFaceRuntimeService is a special kind of WatchFaceService, which loads the watch face definition from another resource only watch face package (see the resourceOnlyWatchFacePackageName parameter passed to createUserStyleSchema, createComplicationSlotsManager, createUserStyleFlavors and createWatchFace).

WatchFaceRuntimeServices are required to be stateless as multiple can be created in parallel. If per instance state is required please use StatefulWatchFaceRuntimeService.

Note because a WatchFaceRuntimeService loads it's resources from another package, it will need the following permission:

    <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
        tools:ignore="QueryAllPackagesPermission" />

Currently Wear OS only supports the runtime for the Android Watch Face Format (see https://developer.android.com/training/wearables/wff for more details).

Note only one watch face definition per resource only watch face package is supported.

Summary

Public constructors
`WatchFaceRuntimeService()`

Protected methods
`final @NonNull ComplicationSlotsManager`	`createComplicationSlotsManager( @NonNull CurrentUserStyleRepository currentUserStyleRepository )` If the WatchFaceService's manifest doesn't define a androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty `ComplicationSlotsManager`.
`abstract @NonNull ComplicationSlotsManager`	`@WorkerThread createComplicationSlotsManager( @NonNull CurrentUserStyleRepository currentUserStyleRepository, @NonNull String resourceOnlyWatchFacePackageName )` If the WatchFaceService's manifest doesn't define an androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty `ComplicationSlotsManager`.
`final @NonNull UserStyleFlavors`	`createUserStyleFlavors( @NonNull CurrentUserStyleRepository currentUserStyleRepository, @NonNull ComplicationSlotsManager complicationSlotsManager )` If the WatchFaceService's manifest doesn't define a androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create non-empty `UserStyleFlavors`.
`abstract @NonNull UserStyleFlavors`	`@WorkerThread createUserStyleFlavors( @NonNull CurrentUserStyleRepository currentUserStyleRepository, @NonNull ComplicationSlotsManager complicationSlotsManager, @NonNull String resourceOnlyWatchFacePackageName )` If the WatchFaceService's manifest doesn't define an androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create non-empty `UserStyleFlavors`.
`final @NonNull UserStyleSchema`	`createUserStyleSchema()` If the WatchFaceService's manifest doesn't define an androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty `UserStyleSchema`.
`abstract @NonNull UserStyleSchema`	`@WorkerThread createUserStyleSchema(@NonNull String resourceOnlyWatchFacePackageName)` If the WatchFaceService's manifest doesn't define a androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty `UserStyleSchema`.
`final @NonNull WatchFace`	`createWatchFace( @NonNull SurfaceHolder surfaceHolder, @NonNull WatchState watchState, @NonNull ComplicationSlotsManager complicationSlotsManager, @NonNull CurrentUserStyleRepository currentUserStyleRepository )` Override this factory method to create your WatchFaceImpl.
`abstract @NonNull WatchFace`	`@WorkerThread createWatchFace( @NonNull SurfaceHolder surfaceHolder, @NonNull WatchState watchState, @NonNull ComplicationSlotsManager complicationSlotsManager, @NonNull CurrentUserStyleRepository currentUserStyleRepository, @NonNull String resourceOnlyWatchFacePackageName )` Override this factory method to create your WatchFaceImpl.

Inherited methods

From android.content.Context

`boolean`	`bindIsolatedService( @NonNull Intent p0, @NonNull Context.BindServiceFlags p1, @NonNull String p2, @NonNull Executor p3, @NonNull ServiceConnection p4 )`
`final int`	`getColor(int p0)`
`final @NonNull ColorStateList`	`getColorStateList(int p0)`
`final @Nullable Drawable`	`getDrawable(int p0)`
`final @NonNull String`	`getString(int p0)`
`final @NonNull String`	`getString(int p0, @NonNull Object p1)`
`final @NonNull T`	`<T extends Object> getSystemService(@NonNull Class<@NonNull T> p0)`
`final @NonNull CharSequence`	`getText(int p0)`
`final @NonNull TypedArray`	`obtainStyledAttributes(@NonNull int[] p0)`
`final @NonNull TypedArray`	`obtainStyledAttributes(@Nullable AttributeSet p0, @NonNull int[] p1)`
`final @NonNull TypedArray`	`obtainStyledAttributes(int p0, @NonNull int[] p1)`
`final @NonNull TypedArray`	`obtainStyledAttributes( @Nullable AttributeSet p0, @NonNull int[] p1, int p2, int p3 )`
`void`	`revokeSelfPermissionOnKill(@NonNull String p0)`
`void`	`sendBroadcastWithMultiplePermissions( @NonNull Intent p0, @NonNull String[] p1 )`

From android.content.ContextWrapper

`boolean`	`bindIsolatedService( @NonNull Intent p0, int p1, @NonNull String p2, @NonNull Executor p3, @NonNull ServiceConnection p4 )`
`boolean`	`bindService( @NonNull Intent p0, @NonNull ServiceConnection p1, @NonNull Context.BindServiceFlags p2 )`
`boolean`	`bindService(@NonNull Intent p0, @NonNull ServiceConnection p1, int p2)`
`boolean`	`bindService( @NonNull Intent p0, @NonNull Context.BindServiceFlags p1, @NonNull Executor p2, @NonNull ServiceConnection p3 )`
`boolean`	`bindService( @NonNull Intent p0, int p1, @NonNull Executor p2, @NonNull ServiceConnection p3 )`
`boolean`	`bindServiceAsUser( @NonNull Intent p0, @NonNull ServiceConnection p1, @NonNull Context.BindServiceFlags p2, @NonNull UserHandle p3 )`
`boolean`	`bindServiceAsUser( @NonNull Intent p0, @NonNull ServiceConnection p1, int p2, @NonNull UserHandle p3 )`
`int`	`checkCallingOrSelfPermission(@NonNull String p0)`
`int`	`checkCallingOrSelfUriPermission(@NonNull Uri p0, int p1)`
`@NonNull int[]`	`checkCallingOrSelfUriPermissions(@NonNull List<@NonNull Uri> p0, int p1)`
`int`	`checkCallingPermission(@NonNull String p0)`
`int`	`checkCallingUriPermission(@NonNull Uri p0, int p1)`
`@NonNull int[]`	`checkCallingUriPermissions(@NonNull List<@NonNull Uri> p0, int p1)`
`int`	`checkPermission(@NonNull String p0, int p1, int p2)`
`int`	`checkSelfPermission(@NonNull String p0)`
`int`	`checkUriPermission(@NonNull Uri p0, int p1, int p2, int p3)`
`int`	`checkUriPermission( @Nullable Uri p0, @Nullable String p1, @Nullable String p2, int p3, int p4, int p5 )`
`@NonNull int[]`	`checkUriPermissions(@NonNull List<@NonNull Uri> p0, int p1, int p2, int p3)`
`void`	`clearWallpaper()` This method is deprecated. Deprecated in Java
`@NonNull Context`	`createAttributionContext(@Nullable String p0)`
`@NonNull Context`	`createConfigurationContext(@NonNull Configuration p0)`
`@NonNull Context`	`createContext(@NonNull ContextParams p0)`
`@NonNull Context`	`createContextForSplit(@NonNull String p0)`
`@NonNull Context`	`createDeviceContext(int p0)`
`@NonNull Context`	`createDeviceProtectedStorageContext()`
`@NonNull Context`	`createDisplayContext(@NonNull Display p0)`
`@NonNull Context`	`createPackageContext(@NonNull String p0, int p1)`
`@NonNull Context`	`createWindowContext(int p0, @Nullable Bundle p1)`
`@NonNull Context`	`createWindowContext(@NonNull Display p0, int p1, @Nullable Bundle p2)`
`@NonNull String[]`	`databaseList()`
`boolean`	`deleteDatabase(@NonNull String p0)`
`boolean`	`deleteFile(@NonNull String p0)`
`boolean`	`deleteSharedPreferences(@NonNull String p0)`
`void`	`enforceCallingOrSelfPermission(@NonNull String p0, @Nullable String p1)`
`void`	`enforceCallingOrSelfUriPermission( @NonNull Uri p0, int p1, @NonNull String p2 )`
`void`	`enforceCallingPermission(@NonNull String p0, @Nullable String p1)`
`void`	`enforceCallingUriPermission(@NonNull Uri p0, int p1, @NonNull String p2)`
`void`	`enforcePermission(@NonNull String p0, int p1, int p2, @Nullable String p3)`
`void`	`enforceUriPermission( @NonNull Uri p0, int p1, int p2, int p3, @NonNull String p4 )`
`void`	`enforceUriPermission( @Nullable Uri p0, @Nullable String p1, @Nullable String p2, int p3, int p4, int p5, @Nullable String p6 )`
`@NonNull String[]`	`fileList()`
`@NonNull Context`	`getApplicationContext()`
`@NonNull ApplicationInfo`	`getApplicationInfo()`
`@NonNull AssetManager`	`getAssets()`
`@NonNull AttributionSource`	`getAttributionSource()`
`@Nullable String`	`getAttributionTag()`
`@NonNull Context`	`getBaseContext()`
`@NonNull File`	`getCacheDir()`
`@NonNull ClassLoader`	`getClassLoader()`
`@NonNull File`	`getCodeCacheDir()`
`@NonNull ContentResolver`	`getContentResolver()`
`@NonNull File`	`getDataDir()`
`@NonNull File`	`getDatabasePath(@NonNull String p0)`
`int`	`getDeviceId()`
`@NonNull File`	`getDir(@NonNull String p0, int p1)`
`@Nullable Display`	`getDisplay()`
`@Nullable File`	`getExternalCacheDir()`
`@NonNull File[]`	`getExternalCacheDirs()`
`@Nullable File`	`getExternalFilesDir(@Nullable String p0)`
`@NonNull File[]`	`getExternalFilesDirs(@NonNull String p0)`
`@NonNull File[]`	`getExternalMediaDirs()`
`@NonNull File`	`getFileStreamPath(@NonNull String p0)`
`@NonNull File`	`getFilesDir()`
`@NonNull Executor`	`getMainExecutor()`
`@NonNull Looper`	`getMainLooper()`
`@NonNull File`	`getNoBackupFilesDir()`
`@NonNull File`	`getObbDir()`
`@NonNull File[]`	`getObbDirs()`
`@NonNull String`	`getOpPackageName()`
`@NonNull String`	`getPackageCodePath()`
`@NonNull PackageManager`	`getPackageManager()`
`@NonNull String`	`getPackageName()`
`@NonNull String`	`getPackageResourcePath()`
`@Nullable ContextParams`	`getParams()`
`@NonNull Resources`	`getResources()`
`@NonNull SharedPreferences`	`getSharedPreferences(@NonNull String p0, int p1)`
`@NonNull Object`	`getSystemService(@NonNull String p0)`
`String`	`getSystemServiceName(@NonNull Class<@NonNull ?> p0)`
`@NonNull Resources.Theme`	`getTheme()`
`@NonNull Drawable`	`getWallpaper()` This method is deprecated. Deprecated in Java
`int`	`getWallpaperDesiredMinimumHeight()` This method is deprecated. Deprecated in Java
`int`	`getWallpaperDesiredMinimumWidth()` This method is deprecated. Deprecated in Java
`void`	`grantUriPermission(@NonNull String p0, @NonNull Uri p1, int p2)`
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`isUiContext()`
`boolean`	`moveDatabaseFrom(@NonNull Context p0, @NonNull String p1)`
`boolean`	`moveSharedPreferencesFrom(@NonNull Context p0, @NonNull String p1)`
`@NonNull FileInputStream`	`openFileInput(@NonNull String p0)`
`@NonNull FileOutputStream`	`openFileOutput(@NonNull String p0, int p1)`
`@NonNull SQLiteDatabase`	`openOrCreateDatabase( @NonNull String p0, int p1, @NonNull SQLiteDatabase.CursorFactory p2 )`
`@NonNull SQLiteDatabase`	`openOrCreateDatabase( @NonNull String p0, int p1, @NonNull SQLiteDatabase.CursorFactory p2, @Nullable DatabaseErrorHandler p3 )`
`@NonNull Drawable`	`peekWallpaper()` This method is deprecated. Deprecated in Java
`void`	`registerComponentCallbacks(@NonNull ComponentCallbacks p0)`
`void`	`registerDeviceIdChangeListener( @NonNull Executor p0, @NonNull IntConsumer p1 )`
`Intent`	`registerReceiver(@Nullable BroadcastReceiver p0, @NonNull IntentFilter p1)`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver p0, @NonNull IntentFilter p1, int p2 )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver p0, @NonNull IntentFilter p1, @Nullable String p2, @Nullable Handler p3 )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver p0, @NonNull IntentFilter p1, @Nullable String p2, @Nullable Handler p3, int p4 )`
`void`	`removeStickyBroadcast(@NonNull Intent p0)` This method is deprecated. Deprecated in Java
`void`	`removeStickyBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1)` This method is deprecated. Deprecated in Java
`void`	`revokeSelfPermissionsOnKill(@NonNull Collection<@NonNull String> p0)`
`void`	`revokeUriPermission(@NonNull Uri p0, int p1)`
`void`	`revokeUriPermission(@NonNull String p0, @NonNull Uri p1, int p2)`
`void`	`sendBroadcast(@NonNull Intent p0)`
`void`	`sendBroadcast(@NonNull Intent p0, @Nullable String p1)`
`void`	`sendBroadcast(@NonNull Intent p0, @Nullable String p1, @Nullable Bundle p2)`
`void`	`sendBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1)`
`void`	`sendBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1, String p2)`
`void`	`sendOrderedBroadcast(@NonNull Intent p0, @Nullable String p1)`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable Bundle p2 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable BroadcastReceiver p2, @Nullable Handler p3, int p4, @Nullable String p5, @Nullable Bundle p6 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable Bundle p2, @Nullable BroadcastReceiver p3, @Nullable Handler p4, int p5, @Nullable String p6, @Nullable Bundle p7 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable String p2, @Nullable BroadcastReceiver p3, @Nullable Handler p4, int p5, @Nullable String p6, @Nullable Bundle p7 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, int p1, @Nullable String p2, @Nullable String p3, @Nullable BroadcastReceiver p4, @Nullable Handler p5, @Nullable String p6, @Nullable Bundle p7, @Nullable Bundle p8 )`
`void`	`sendOrderedBroadcastAsUser( @NonNull Intent p0, @NonNull UserHandle p1, @Nullable String p2, @Nullable BroadcastReceiver p3, @Nullable Handler p4, int p5, @Nullable String p6, @Nullable Bundle p7 )`
`void`	`sendStickyBroadcast(@NonNull Intent p0)` This method is deprecated. Deprecated in Java
`void`	`sendStickyBroadcast(@NonNull Intent p0, @Nullable Bundle p1)` This method is deprecated. Deprecated in Java
`void`	`sendStickyBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1)` This method is deprecated. Deprecated in Java
`void`	`sendStickyOrderedBroadcast( @NonNull Intent p0, @Nullable BroadcastReceiver p1, @Nullable Handler p2, int p3, @Nullable String p4, @Nullable Bundle p5 )` This method is deprecated. Deprecated in Java
`void`	`sendStickyOrderedBroadcastAsUser( @NonNull Intent p0, @NonNull UserHandle p1, @Nullable BroadcastReceiver p2, @Nullable Handler p3, int p4, @Nullable String p5, @Nullable Bundle p6 )` This method is deprecated. Deprecated in Java
`void`	`setTheme(int p0)`
`void`	`setWallpaper(@NonNull Bitmap p0)` This method is deprecated. Deprecated in Java
`void`	`setWallpaper(@NonNull InputStream p0)` This method is deprecated. Deprecated in Java
`void`	`startActivities(@NonNull Intent[] p0)`
`void`	`startActivities(@NonNull Intent[] p0, @Nullable Bundle p1)`
`void`	`startActivity(@NonNull Intent p0)`
`void`	`startActivity(@NonNull Intent p0, @Nullable Bundle p1)`
`@Nullable ComponentName`	`startForegroundService(@NonNull Intent p0)`
`boolean`	`startInstrumentation( @NonNull ComponentName p0, @Nullable String p1, @Nullable Bundle p2 )`
`void`	`startIntentSender( @NonNull IntentSender p0, @Nullable Intent p1, int p2, int p3, int p4 )`
`void`	`startIntentSender( @NonNull IntentSender p0, @Nullable Intent p1, int p2, int p3, int p4, @Nullable Bundle p5 )`
`@Nullable ComponentName`	`startService(@NonNull Intent p0)`
`boolean`	`stopService(@NonNull Intent p0)`
`void`	`unbindService(@NonNull ServiceConnection p0)`
`void`	`unregisterComponentCallbacks(@NonNull ComponentCallbacks p0)`
`void`	`unregisterDeviceIdChangeListener(@NonNull IntConsumer p0)`
`void`	`unregisterReceiver(@NonNull BroadcastReceiver p0)`
`void`	`updateServiceGroup(@NonNull ServiceConnection p0, int p1, int p2)`

From android.app.Service

`void`	`attachBaseContext(@NonNull Context p0)`
`final @NonNull Application`	`getApplication()`
`final int`	`getForegroundServiceType()`
`void`	`onLowMemory()`
`void`	`onRebind(@NonNull Intent p0)`
`void`	`onStart(@NonNull Intent p0, int p1)` This method is deprecated. Deprecated in Java
`int`	`onStartCommand(@NonNull Intent p0, int p1, int p2)`
`void`	`onTaskRemoved(@NonNull Intent p0)`
`void`	`onTimeout(int p0)`
`void`	`onTrimMemory(int p0)`
`boolean`	`onUnbind(@NonNull Intent p0)`
`final void`	`startForeground(int p0, @NonNull Notification p1)`
`final void`	`startForeground(int p0, @NonNull Notification p1, int p2)`
`final void`	`stopForeground(boolean p0)` This method is deprecated. Deprecated in Java
`final void`	`stopForeground(int p0)`
`final void`	`stopSelf()`
`final void`	`stopSelf(int p0)`
`final boolean`	`stopSelfResult(int p0)`

From android.service.wallpaper.WallpaperService

`final IBinder`	`onBind(@NonNull Intent p0)`
`void`	`onCreate()`
`void`	`onDestroy()`

From androidx.wear.watchface.WatchFaceService

`void`	`@UiThread dump( @NonNull FileDescriptor fd, @NonNull PrintWriter writer, @NonNull String[] args )`
`final @NonNull Handler`	`getBackgroundThreadHandler()` Returns the lazily constructed background thread `Handler`.
`ComplicationSlotInflationFactory`	`@WorkerThread getComplicationSlotInflationFactory()` This method is deprecated. Use the version with currentUserStyleRepository argument instead
`@NonNull ComplicationSlotInflationFactory`	`@WorkerThread getComplicationSlotInflationFactory( @NonNull CurrentUserStyleRepository currentUserStyleRepository )` Used when inflating `ComplicationSlot`s from XML (i.e the manifest contains androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition metadata) to provide a `ComplicationSlotInflationFactory` which provides the `CanvasComplicationFactory` and where necessary edge complication `ComplicationTapFilter`s needed for inflating `ComplicationSlot`s.
`final @NonNull Handler`	`getUiThreadHandler()` Returns the ui thread `Handler`.
`void`	`onConfigurationChanged(@NonNull Configuration newConfig)`
`final @NonNull WallpaperService.Engine`	`onCreateEngine()` Creates an interactive engine for WallpaperService.

Public constructors

WatchFaceRuntimeService

Added in 1.2.0

public WatchFaceRuntimeService()

Protected methods

createComplicationSlotsManager

Added in 1.3.0-alpha04

protected final @NonNull ComplicationSlotsManager createComplicationSlotsManager(
    @NonNull CurrentUserStyleRepository currentUserStyleRepository
)

If the WatchFaceService's manifest doesn't define a androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty ComplicationSlotsManager. This manager will be passed to createUserStyleFlavors and createWatchFace. This will be called from a background thread but the ComplicationSlotsManager should be accessed exclusively from the UiThread afterwards.

Parameters
`@NonNull CurrentUserStyleRepository currentUserStyleRepository`	The `CurrentUserStyleRepository` constructed using the `UserStyleSchema` returned by `createUserStyleSchema`.

Returns
`@NonNull ComplicationSlotsManager`	The `ComplicationSlotsManager` to pass into `createWatchFace`.

createComplicationSlotsManager

Added in 1.2.0

@WorkerThread
protected abstract @NonNull ComplicationSlotsManager createComplicationSlotsManager(
    @NonNull CurrentUserStyleRepository currentUserStyleRepository,
    @NonNull String resourceOnlyWatchFacePackageName
)

If the WatchFaceService's manifest doesn't define an androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty ComplicationSlotsManager. This manager will be passed to createUserStyleFlavors and createWatchFace. This will be called from a background thread but the ComplicationSlotsManager should be accessed exclusively from the UiThread afterwards.

Parameters
`@NonNull CurrentUserStyleRepository currentUserStyleRepository`	The `CurrentUserStyleRepository` constructed using the `UserStyleSchema` returned by `createUserStyleSchema`.
`@NonNull String resourceOnlyWatchFacePackageName`	The android package from which the watch face definition should be loaded.

Returns
`@NonNull ComplicationSlotsManager`	The `ComplicationSlotsManager` to pass into `createWatchFace`.

createUserStyleFlavors

Added in 1.3.0-alpha04

protected final @NonNull UserStyleFlavors createUserStyleFlavors(
    @NonNull CurrentUserStyleRepository currentUserStyleRepository,
    @NonNull ComplicationSlotsManager complicationSlotsManager
)

If the WatchFaceService's manifest doesn't define a androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create non-empty UserStyleFlavors. This is called on a background thread. The system reads the flavors once and changes may be ignored until the APK is updated. Metadata tag "androidx.wear.watchface.FLAVORS_SUPPORTED" should be added to let the system know the service supports flavors.

Parameters
`@NonNull CurrentUserStyleRepository currentUserStyleRepository`	The `CurrentUserStyleRepository` constructed using the `UserStyleSchema` returned by `createUserStyleSchema`.
`@NonNull ComplicationSlotsManager complicationSlotsManager`	The `ComplicationSlotsManager` returned by `createComplicationSlotsManager`

Returns
`@NonNull UserStyleFlavors`	The `UserStyleFlavors`, which is exposed to the system.

createUserStyleFlavors

Added in 1.2.0

@WorkerThread
protected abstract @NonNull UserStyleFlavors createUserStyleFlavors(
    @NonNull CurrentUserStyleRepository currentUserStyleRepository,
    @NonNull ComplicationSlotsManager complicationSlotsManager,
    @NonNull String resourceOnlyWatchFacePackageName
)

If the WatchFaceService's manifest doesn't define an androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create non-empty UserStyleFlavors. This is called on a background thread. The system reads the flavors once and changes may be ignored until the APK is updated. Metadata tag "androidx.wear.watchface.FLAVORS_SUPPORTED" should be added to let the system know the service supports flavors.

Parameters
`@NonNull CurrentUserStyleRepository currentUserStyleRepository`	The `CurrentUserStyleRepository` constructed using the `UserStyleSchema` returned by `createUserStyleSchema`.
`@NonNull ComplicationSlotsManager complicationSlotsManager`	The `ComplicationSlotsManager` returned by `createComplicationSlotsManager`
`@NonNull String resourceOnlyWatchFacePackageName`	The android package from which the watch face definition should be loaded.

Returns
`@NonNull UserStyleFlavors`	The `UserStyleFlavors`, which is exposed to the system.

createUserStyleSchema

Added in 1.3.0-alpha04

protected final @NonNull UserStyleSchema createUserStyleSchema()

If the WatchFaceService's manifest doesn't define an androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty UserStyleSchema. A CurrentUserStyleRepository constructed with this schema will be passed to createComplicationSlotsManager, createUserStyleFlavors and createWatchFace. This is called on a background thread.

Returns
`@NonNull UserStyleSchema`	The `UserStyleSchema` to create a `CurrentUserStyleRepository` with, which is passed to `createComplicationSlotsManager` and `createWatchFace`.

createUserStyleSchema

Added in 1.2.0

@WorkerThread
protected abstract @NonNull UserStyleSchema createUserStyleSchema(@NonNull String resourceOnlyWatchFacePackageName)

If the WatchFaceService's manifest doesn't define a androidx.wear.watchface.XmlSchemaAndComplicationSlotsDefinition meta data tag then override this factory method to create a non-empty UserStyleSchema. A CurrentUserStyleRepository constructed with this schema will be passed to createComplicationSlotsManager, createUserStyleFlavors and createWatchFace. This is called on a background thread.

Parameters
`@NonNull String resourceOnlyWatchFacePackageName`	The android package from which the watch face definition should be loaded.

Returns
`@NonNull UserStyleSchema`	The `UserStyleSchema` to create a `CurrentUserStyleRepository` with, which is passed to `createComplicationSlotsManager` and `createWatchFace`.

createWatchFace

protected final @NonNull WatchFace createWatchFace(
    @NonNull SurfaceHolder surfaceHolder,
    @NonNull WatchState watchState,
    @NonNull ComplicationSlotsManager complicationSlotsManager,
    @NonNull CurrentUserStyleRepository currentUserStyleRepository
)

Override this factory method to create your WatchFaceImpl. This method will be called by the library on a background thread, if possible any expensive initialization should be done asynchronously. The WatchFace and its Renderer should be accessed exclusively from the UiThread afterwards. There is a memory barrier between construction and rendering so no special threading primitives are required.

Warning the system will likely time out waiting for watch face initialization if it takes longer than MAX_CREATE_WATCHFACE_TIME_MILLIS milliseconds.

Parameters
`@NonNull SurfaceHolder surfaceHolder`	The `SurfaceHolder` to pass to the `Renderer`'s constructor.
`@NonNull WatchState watchState`	The `WatchState` for the watch face.
`@NonNull ComplicationSlotsManager complicationSlotsManager`	The `ComplicationSlotsManager` returned by `createComplicationSlotsManager`.
`@NonNull CurrentUserStyleRepository currentUserStyleRepository`	The `CurrentUserStyleRepository` constructed using the `UserStyleSchema` returned by `createUserStyleSchema`.

Returns
`@NonNull WatchFace`	A `WatchFace` whose `Renderer` uses the provided `surfaceHolder`.

createWatchFace

@WorkerThread
protected abstract @NonNull WatchFace createWatchFace(
    @NonNull SurfaceHolder surfaceHolder,
    @NonNull WatchState watchState,
    @NonNull ComplicationSlotsManager complicationSlotsManager,
    @NonNull CurrentUserStyleRepository currentUserStyleRepository,
    @NonNull String resourceOnlyWatchFacePackageName
)

Warning the system will likely time out waiting for watch face initialization if it takes longer than WatchFaceService.MAX_CREATE_WATCHFACE_TIME_MILLIS milliseconds.

Parameters
`@NonNull SurfaceHolder surfaceHolder`	The `SurfaceHolder` to pass to the `Renderer`'s constructor.
`@NonNull WatchState watchState`	The `WatchState` for the watch face.
`@NonNull ComplicationSlotsManager complicationSlotsManager`	The `ComplicationSlotsManager` returned by `createComplicationSlotsManager`.
`@NonNull CurrentUserStyleRepository currentUserStyleRepository`	The `CurrentUserStyleRepository` constructed using the `UserStyleSchema` returned by `createUserStyleSchema`.
`@NonNull String resourceOnlyWatchFacePackageName`	The android package from which the watch face definition should be loaded.

Returns
`@NonNull WatchFace`	A `WatchFace` whose `Renderer` uses the provided `surfaceHolder`.