Developing Libraries is Hard

Why and how to create a library and discuss potential footguns

Transcript

1. Developing Libraries Is Hard DOMAGOJ KORMAN
2. * * * *
4. * * * * * *
5. SHOULD I MAKE A LIBRARY?
6. SHOULD I MAKE A LIBRARY? • Terrible Google API
7. SHOULD I MAKE A LIBRARY? • Terrible Google API • Common problems
8. SHOULD I MAKE A LIBRARY? • Terrible Google API • Common problems
 • Outdated existing library
9. OUR LIBRARY Draw 2D shape
10. API IMPLEMENTATION CircleDrawer I need I need I need RectangleDrawer draw() Drawer
11. draw() API INTERNAL CONFIGURABLE • Prepare canvas • Prepare paint • Draw shape • Catch/Throw exceptions • Provide paint color • Provide shape
12. INTERNAL CONFIGURABLE BUILDER setShapeProvider() setPaintProvider() build() PaintProvider ShapeProvider
13. draw() API INTERNAL CONFIGURABLE PaintProvider ShapeProvider
14. SHOULD I USE RXJAVA OR KOTLIN?
16. WELL MAYBE
17. METHOD COUNT RxJava: 10,582
 Kotlin-stdlib: 6,106
18. MULTI-MODULE SETUP
19. draw() API INTERNAL CONFIGURABLE PaintProvider ShapeProvider
20. draw() API INTERNAL CONFIGURABLE PaintProvider ShapeProvider rxDraw() RXAPI
21. class RxApiImpl : RxApi { private val api: Api }
22. fun rxDraw(): Observable<Event> { api.draw(object: Callback { override fun onSuccess() = observable.onCompleted() override fun onError(t: Throwable) = observable.onError(t) }) return observable }
23. fun rxDraw(): Observable<Event> { api.draw(object: Callback { override fun onSuccess() = observable.onCompleted() override fun onError(t: Throwable) = observable.onError(t) }) return observable }
24. dependencies { implementation 'co.infinum:draw:1.0.0' implementation 'co.infinum:draw-rx:1.0.0' }
25. I FINISHED MY LIBRARY. AM I READY TO DEPLOY?
27. LIBRARY Code Tests Documentation (Readme, Javadoc, License) Automated release
28. README • Quick guide on top - as short as possible • Complex stuff below
29. JAVADOC • Add javadoc to public API!
30. LICENSES Copyleft Permissive GNU GPL MIT Apache
31. AUTOMATE RELEASE • Gradle Bintray Plugin • Complex to understand and setup • Awesome documentation • Easy to use after setup
32. DEPLOY
33. OUR STUFF https://github.com/infinum/Android-Goldfinger https://github.com/infinum/android-complexify https://github.com/infinum/android_dbinspector https://github.com/infinum/Android-prince-of-versions
34. Visit infinum.co or find us on social networks: infinum.co infinumco infinumco infinum Questions?