Deprecate NativeCanvas typealias

Change-Id: I26098f1b585f1e902ab4cab83f5525beb4dc54eb

Author: MatkovIvan

compose/ui/ui-graphics/src/androidMain/kotlin/androidx/compose/ui/graphics/AndroidCanvas.android.kt

@@ -22,6 +22,10 @@ import androidx.compose.ui.unit.IntOffset
 import androidx.compose.ui.unit.IntSize
 import androidx.compose.ui.util.fastForEach
 
+@Deprecated(
+    message = "Use android.graphics.Canvas directly instead",
+    replaceWith = ReplaceWith("android.graphics.Canvas"),
+)
 actual typealias NativeCanvas = android.graphics.Canvas
 
 /** Create a new Canvas instance that targets its drawing commands to the provided [ImageBitmap] */
@@ -30,6 +34,12 @@ internal actual fun ActualCanvas(image: ImageBitmap): Canvas =
 
 fun Canvas(c: android.graphics.Canvas): Canvas = AndroidCanvas().apply { internalCanvas = c }
 
+fun android.graphics.Canvas.asComposeCanvas(): Canvas =
+    AndroidCanvas().apply { internalCanvas = this@asComposeCanvas }
+
+fun Canvas.asAndroidCanvas(): android.graphics.Canvas =
+    (this as AndroidCanvas).internalCanvas
+
 /**
  * Holder class that is used to issue scoped calls to a [Canvas] from the framework equivalent
  * canvas without having to allocate an object on each draw call
@@ -46,6 +56,11 @@ class CanvasHolder {
 }
 
 /** Return an instance of the native primitive that implements the Canvas interface */
+@Suppress("DEPRECATION")
+@Deprecated(
+    message = "Use Canvas.asAndroidCanvas() extension instead",
+    replaceWith = ReplaceWith("asAndroidCanvas()"),
+)
 actual val Canvas.nativeCanvas: NativeCanvas
     get() = (this as AndroidCanvas).internalCanvas
 

compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/Canvas.kt

@@ -27,6 +27,7 @@ fun Canvas(image: ImageBitmap): Canvas = ActualCanvas(image)
 
 internal expect fun ActualCanvas(image: ImageBitmap): Canvas
 
+@Deprecated("Use direct reference to platform type instead of typealias")
 expect class NativeCanvas
 
 /**
@@ -147,6 +148,8 @@ fun Canvas.scale(sx: Float, sy: Float = sx, pivotX: Float, pivotY: Float) {
 }
 
 /** Return an instance of the native primitive that implements the Canvas interface */
+@Suppress("DEPRECATION")
+@Deprecated("Use platform-specific extension to get platform reference")
 expect val Canvas.nativeCanvas: NativeCanvas
 
 @JvmDefaultWithCompatibility