APIStrat 2016 | How to be a courteous guest: providing SDKs to developers (Devin Sevilla)

B9b8a2b543b485604fc7cccf380d11bc?s=47 API Strategy & Practice Conference
November 03, 2016
Technology
2
81

APIStrat 2016 | How to be a courteous guest: providing SDKs to developers (Devin Sevilla)

Mobile developers are suspicious of including SDKs in their applications. Mobile devices are resource constrained and each application must be a good citizen. It''s easy for SDKs to cause crashes or simply use too many resources, leading to one-star reviews. SDK providers must earn trust and do what they can to protect it. This talk introduces methods to earn the trust of developers and how to manage the fallout from the inevitable bug in your SDK.

B9b8a2b543b485604fc7cccf380d11bc?s=128

API Strategy & Practice Conference

November 03, 2016
Tweet

More Decks by API Strategy & Practice Conference

See All by API Strategy & Practice Conference
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
12
250
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
5
190
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
2
150
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
1
150
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
1
110
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
0
60
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
2
240
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
0
96
B9b8a2b543b485604fc7cccf380d11bc?s=48 apistrat
0
100

Other Decks in Technology

See All in Technology
C0699dfab8761ccede864ec5079519d7?s=48 lrf141
0
200
405fe9ab689473f267e2cfbd95f78c75?s=48 kyonmm
0
360
7e3cdbf62ad6e34cf379443678b1b378?s=48 sogaoh
1
210
Cd823abda454a7a2065fe6fe273ae84b?s=48 viva_tweet_x
2
230
3a9dc8db324dc41de538f0f48e4bd45d?s=48 oguzhan
1
180
F3f3eec8682a76ed430054e8fd994f15?s=48 tmnakagawa
0
660
2102a6b8760bd6f57f672805723dd83a?s=48 line_developers_tw
0
310
3115a782126be714b5f94d24073c957d?s=48 oracle4engineer
0
210
Ea9506ab742ba01d1bea53af6f5649b7?s=48 tsuemura
24
13k
80c79a9d024d1e1a253893a78189ce6d?s=48 ujnak
1
100
1f745ff900e1be51aedae18cae76593c?s=48 kurochan
0
1.6k
B1cc148711c6a37a5c922b6e72a4ad52?s=48 upura
1
830

Featured

See All Featured
D67fff74178013024d833b3eec6cf27f?s=48 lynnandtonic
264
16k
E13c31390e0369fcd5972292ce0e7b92?s=48 jnunemaker
40
4.3k
Ecdea9b9714877b86cee08458f085481?s=48 trallard
5
200
96270e4c3e5e9806cf7245475c00b275?s=48 addyosmani
494
110k
9375a9529679f1b42b567a640d775e7d?s=48 schacon
144
6.4k
Ded01cdab114abe4ec13511e4c25b9bb?s=48 andyhume
60
2.4k
9128d500301ae51524e887bb680f471d?s=48 caitiem20
300
16k
0c6fd6a08d0f898159cda7cafcacf07f?s=48 afnizarnur
175
14k
1b8ad785acdd1ce1c99914b1c2a4e10e?s=48 sugarenia
230
740k
96270e4c3e5e9806cf7245475c00b275?s=48 addyosmani
1348
190k
C35e01544a0dd94a2cf1619ee8a42ebb?s=48 clairelew
7
1.1k
C9b18d9dff88a9dd2393364c2b3b21bd?s=48 colly
65
2.9k

Transcript

  1. How to be a courteous guest Providing mobile SDKs Devin

    Sevilla APIStrat Boston 2016

  2. Previously — Engineering Manager, API Currently — Partner API Technical

    Program Manager Credentials

  3. • iOS & Android SDKs • Partners ◦ Shazam ◦

    SoundHound ◦ SoundTracking ◦ Billboard Music Awards ◦ Various music festivals Rdio Developer Program

  4. Will you get invited?

  5. • Provide complete documentation • Share your roadmap • Share

    known issues, limitations Build trust with no surprises

  6. • Closed source feels like less control • They won’t

    look at the source, but it’s nice to know it’s there • Alternative — open source SDK that depends on a minimal closed source library Consider an Open Source SDK

  7. Easy to get started (make it easy to invite you)

    • Dependency management is easier than ever ◦ Maven Central Repository (Android) ◦ CocoaPods (iOS) • Provide a tutorial with how to install and configure

  8. You’re invited! Now what?

  9. • OS and framework versions (deployment target) • External dependencies

    • Permissions • Don’t expect to use the latest features • Expect to drop support for old versions until the last moment Permissions and Versions (Dress code)

  10. Be efficient (Don't eat the whole deli tray) • Battery

    — Don’t keep GPS, radios on • Network — Don’t use too much data • Package size — Keep downloads small

  11. Share resources (Be nice to the other guests) • Let

    them know you're going to take control or release shared resources • Let them say yes or no (the app might already have control)

  12. You spilled a glass of wine

  13. Have a release and support process • Do your partners

    know how to report issues? Do they know what to include in a report? • How quickly can you build, test, and deploy a bug fix? • Make it easy to talk to a human • Provide frequent updates, even if it isn’t fixed yet

  14. Logs • Log enough detail to help you diagnose •

    Don’t leak user information • Log what you’re doing, not the data you’re using

  15. Debug Builds • Your release process should include debug builds

    • Log additional steps and the data you’re using • Use an API proxy for detailed HTTP request logging

  16. Recap

  17. ❏ Document your roadmap, known issues ❏ Consider an open

    source SDK ❏ Host your SDK in a public package repository ❏ Create a tutorial to ease getting started ❏ Implement callbacks for shared resources ❏ Also build a debug version of your SDK Actions

  18. Devin Sevilla • devin.sevilla@adroll.com • devinsevilla.com • @devin_s