Retrofit: Adapters are not documented well

Created on 28 Oct 2016  路  2Comments  路  Source: square/retrofit

The documentation at https://square.github.io/retrofit/ does not tell users about the existing RxJava, Guava and Java8 adapter options.
Also, I realize that you want to keep the project small but you could at least link to some other call adapters. I'm looking at https://github.com/square/retrofit/tree/master/retrofit-adapters which misses support for Bolts and Agera (lightweight Rx). Many people already have Bolts via the Facebook SDK and Agera is nice to know when you can't use multidex as Rx is giant.
Here are links to implementations:
https://github.com/zeng1990java/retrofit-bolts-call-adapter
https://github.com/drakeet/retrofit-agera-call-adapter

Documentation

Most helpful comment

The website should be updated to at least mention them. It's hard to balance what's important for the website or else it would turn into being 100 pages long.

you could at least link to some other call adapters

None existed at the time because we invented the API and therefore had the only implementations. A Wiki page has always existed which I just updated to link to the two you provided.

That said...

Many people already have Bolts via the Facebook SDK

We also have AsyncTask via the Android SDK but that does not mean one should use it.

Agera is nice to know when you can't use multidex as Rx is giant

Yes it's hard to squeeze in RxJava when the support libraries and play services eating up about 80,000 methods.

All 2 comments

The website should be updated to at least mention them. It's hard to balance what's important for the website or else it would turn into being 100 pages long.

you could at least link to some other call adapters

None existed at the time because we invented the API and therefore had the only implementations. A Wiki page has always existed which I just updated to link to the two you provided.

That said...

Many people already have Bolts via the Facebook SDK

We also have AsyncTask via the Android SDK but that does not mean one should use it.

Agera is nice to know when you can't use multidex as Rx is giant

Yes it's hard to squeeze in RxJava when the support libraries and play services eating up about 80,000 methods.

I added a new section for adapters

Was this page helpful?
0 / 5 - 0 ratings