3. Blah blah bla
2. Bla blah bla
1. Blah blah blah
RELEASE
NOTES
Slide 9
Slide 9 text
4. EXPERIMENTAL APIs.
They are subject to
change and not final!!!
3. Blah blah bla
2. Bla blah bla
1. Blah blah blah
RELEASE
NOTES
Slide 10
Slide 10 text
Project Manager
Developer
Cool, thanks
Here’s the new
Version!
SDK
Slide 11
Slide 11 text
4. APIs have been removed.
3. Blah blah bla
2. Bla blah bla
1. Blah blah blah
RELEASE
NOTES
Slide 12
Slide 12 text
Project Manager
Developer
Cool, thanks
Here’s the new
Version!
SDK
Slide 13
Slide 13 text
Slack Message
PROJECT MANAGER
$CUSTOMER JUST CALLED THEY HAVE A BUILD
ERROR WITH THE NEW SDK VERSION CAN YOU FIX
THAT NOW PLS
Friday, 9PM
Slide 14
Slide 14 text
You: Have they read the release notes?
PM: I’ll ask
...
PM: No
Slide 15
Slide 15 text
@Experimental
@Deprecated
Slide 16
Slide 16 text
@Target(ANNOTATION_CLASS)
public annotation class Experimental(val level: Level =
Level.ERROR) {
public enum class Level {
WARNING,
ERROR,
}
}
Slide 17
Slide 17 text
@Target(ANNOTATION_CLASS)
public annotation class Experimental(val level: Level =
Level.ERROR) {
public enum class Level {
WARNING,
ERROR,
}
}
Slide 18
Slide 18 text
@Target(ANNOTATION_CLASS)
public annotation class Experimental(val level: Level =
Level.ERROR) {
public enum class Level {
WARNING,
ERROR,
}
}
Slide 19
Slide 19 text
@Experimental
annotation class ExperimentalCatPicturesAPI
Slide 20
Slide 20 text
class CatPicturesAPI {
/**
* Experimental in case cats overtake the planet and
* demand pets and treats in exchange for cat pictures
*/
@ExperimentalCatPicturesAPI
fun getCatPicture(): CatPicture = CatPicture()
}
Slide 21
Slide 21 text
fun doCatPictureAPIStuff() {
val catPicturesAPI = CatPicturesAPI()
catPicturesAPI.getCatPicture()
} This API is experimental and its usage
must be marked with @UseExperimental.
Slide 22
Slide 22 text
@ExperimentalCatPicturesAPI
fun doCatPictureAPIStuff() {
val catPicturesAPI = CatPicturesAPI()
catPicturesAPI.getCatPicture()
}
Slide 23
Slide 23 text
@UseExperimental(ExperimentalCatPicturesAPI::class)
fun doCatPictureAPIStuff() {
val catPicturesAPI = CatPicturesAPI()
catPicturesAPI.getCatPicture()
}
Slide 24
Slide 24 text
Productive Developer
Slide 25
Slide 25 text
Project Man
Developer
Slide 26
Slide 26 text
Project Manager
Developer
Slide 27
Slide 27 text
Project Manager
Developer
Slide 28
Slide 28 text
Project Manager
Developer
Slide 29
Slide 29 text
Project Manager
Developer
Hey could you ship the
new SDK version?
Slide 30
Slide 30 text
Project Manager
Developer
Hey could you ship the
new SDK version?
S-s-sure…
Slide 31
Slide 31 text
4. APIs have been
deprecated.
3. Blah blah bla
2. Bla blah bla
1. Blah blah blah
RELEASE
NOTES
Slide 32
Slide 32 text
Project Manager
Developer
Cool, thanks
Here’s the new
Version!
SDK
Contains
deprecated APIs
Slide 33
Slide 33 text
Project Manager
Cool, thanks
SDK User
Here’s the new
Version!
SDK
Contains
deprecated APIs
/**
* Marks the annotated declaration as deprecated.
*/ TYPEALIAS)
annotation class Deprecated(
val message: String,
val replaceWith: ReplaceWith = ReplaceWith(""),
val level: DeprecationLevel = DeprecationLevel.WARNING
)
Slide 36
Slide 36 text
@Deprecated(“This is a legacy API. Please use
the new CatPicturesAPI instead.")
class LegacyCatPictureAPI {
fun getCatPicture(): CatPicture = CatPicture()
}
Slide 37
Slide 37 text
val api = LegacyCatPictureAPI()
Slide 38
Slide 38 text
/**
* Marks the annotated declaration as deprecated.
*/ TYPEALIAS)
annotation class Deprecated(
val message: String,
val replaceWith: ReplaceWith = ReplaceWith(""),
val level: DeprecationLevel = DeprecationLevel.WARNING
)
Slide 39
Slide 39 text
annotation class ReplaceWith(
val expression: String,
vararg val imports: String
)
Slide 40
Slide 40 text
@Deprecated(
"This is a legacy API. Please use the new
CatPicturesAPI instead.",
ReplaceWith("CatPicturesAPI")
)
class LegacyCatPictureAPI {
fun getCatPicture(): CatPicture = CatPicture()
}
Slide 41
Slide 41 text
@Deprecated(
"This is a legacy API. Please use the new
CatPicturesAPI instead.",
ReplaceWith("CatPicturesAPI")
)
class LegacyCatPictureAPI {
fun getCatPicture(): CatPicture = CatPicture()
}
Slide 42
Slide 42 text
val api = LegacyCatPictureAPI()
Replace with ‘CatPicturesAPI’
Slide 43
Slide 43 text
val api = LegacyCatPictureAPI()
Replace with ‘CatPicturesAPI’
Alt + Enter
Slide 44
Slide 44 text
val api = CatPicturesAPI()
✔Occurrence Replaced!
Slide 45
Slide 45 text
class Laboratory {
fun getRandommChemical(): Chemical
= randomExperiment + randomExperiment + explosive
}
Slide 46
Slide 46 text
class Laboratory {
@Deprecated(
"Typo in here. Please use getRandomChemical instead.",
ReplaceWith("getRandomChemical")
)
fun getRandommChemical(): Chemical
= randomExperiment + randomExperiment + explosive
}
Slide 47
Slide 47 text
class Laboratory {
@Deprecated(
"Typo in here. Please use getRandomChemical instead.",
ReplaceWith("getRandomChemical")
)
fun getRandommChemical(): Chemical
= randomExperiment + randomExperiment + explosive
fun getRandomChemical(): Chemical
= randomExperiment + randomExperiment + explosive
}
Slide 48
Slide 48 text
class Laboratory {
@Deprecated(
"Typo in here. Please use getRandomChemical instead.",
ReplaceWith("getRandomChemical")
)
fun getRandommChemical(): Chemical
= getRandomChemical()
fun getRandomChemical(): Chemical
= randomExperiment + randomExperiment + explosive
}
Slide 49
Slide 49 text
class CatPicturesAPI {
/**
* Experimental in case cats overtake the planet and
* demand pets and treats in exchange for cat pictures
*/
@ExperimentalCatPicturesAPI
fun getCatPicture(): CatPicture = CatPicture()
}
Slide 50
Slide 50 text
class CatPictureAPI {
/**
* Experimental in case cats overtake the planet and
* demand pets and treats in exchange for cat pictures
*/
@ExperimentalCatPicturesAPI
fun getCatPicture(): CatPicture = CatPicture()
}
Slide 51
Slide 51 text
@Deprecated(
message = "CatPicturesAPI has been renamed
to CatPictureAPI“,
replaceWith = ReplaceWith("CatPictureAPI")
)
typealias CatPicturesAPI = CatPictureAPI
Slide 52
Slide 52 text
No content
Slide 53
Slide 53 text
SDK
Slide 54
Slide 54 text
interface SDKCapabilities {
...
}
class ArtboardSDK: SDKCapabilities {
//It'll become super bloated
}
Slide 55
Slide 55 text
interface CanvasCapabilities
interface SDKCapabilities: CanvasCapabilities
class ArtboardSDK: SDKCapabilities {
val canvasManager = CanvasManager()
override fun draw() = canvasManager.draw()
}
Slide 56
Slide 56 text
interface CanvasCapabilities
interface SDKCapabilities: CanvasCapabilities
class ArtboardSDK: SDKCapabilities {
val canvasManager = CanvasManager()
override fun draw() = canvasManager.draw()
}
Slide 57
Slide 57 text
interface CanvasCapabilities
interface SDKCapabilities: CanvasCapabilities
class ArtboardSDK: SDKCapabilities {
val canvasManager = CanvasManager()
override fun draw() = canvasManager.draw()
}
Slide 58
Slide 58 text
interface CanvasCapabilities
interface SDKCapabilities: CanvasCapabilities
class CanvasManager: CanvasCapabilities
class ArtboardSDK:
SDKCapabilities,
CanvasCapabilities by CanvasManager()
Slide 59
Slide 59 text
interface CanvasCapabilities
interface SDKCapabilities: CanvasCapabilities
class CanvasManager: CanvasCapabilities
class ArtboardSDK:
SDKCapabilities,
CanvasCapabilities by CanvasManager()