A mi me ocurrió algo parecido a lo tuyo1, así que estuve leyendo el apartado el enlace al que me mandaba el mensajeUsar las nuevas configuraciones de errordependencias de la documentación de Android.
Allí explican la diferencia (las negritas son mías):
##
implementation
La dependencia está disponible en el momento de la compilación para el móduloel módulo y solo en el tiempo de ejecución para el consumidor del módulo. Para compilaciones grandes que abarcan varios proyectos, el uso de implementation en lugar de api o compile puede generar mejoras importantes en el tiempo de compilaciónmódulo. Para compilaciones grandes que abarcan varios proyectos, el uso de
implementation
en lugar deapi
ocompile
puede generar mejoras importantes en el tiempo de compilación, ya que reduce la cantidad de proyectoscantidad de proyectos que el sistema de compilación debe volver a compilar. La mayoría de los módulos de apps y de prueba deben usar esta configuracióncompilar. La mayoría de los módulos de apps y de prueba deben usar esta configuración.
##
api
La dependencia está disponible para el módulo en el momento de la compilación, y también está disponible para el consumidor del módulo en el momento de la compilación y en el tiempo de ejecución. Esta configuración tiene el mismo comportamiento que compile
compile
(que ahora es obsoleta) y normalmente deberías usarla solo en los módulos de la bibliotecanormalmente deberías usarla solo en los módulos de la biblioteca. Los módulos de la app deben usar implementationimplementation
, a menos que desees exponer su API a otro módulo de prueba.Como en el caso de las versiones estables actuales del complemento de Android, las configuraciones anteriores están disponibles para dependencias de clases o tipos de compilación específicas. Por ejemplo, puedes usar
api
para que la dependencia esté disponible para todas las variantes, o bienredApi
para que esté disponible únicamente para las variantes red del módulo.
Y finalmente, una nota:
Nota:
compile
,provided
yapk
siguen estando disponibles. Sin embargo, desaparecerán en la próxima versión importante del complemento de Android.
1Pregunta relacionada: ¿Cómo aplicar las nuevas configuraciones de dependencia de Android Studio?