java - downloads - ¿Qué es ''API Baseline'' en Eclipse PDT?

pde ciudad

Question

Desde la actualización a Eclipse 3.7, el plugin Eclipse PDE quiere que especifique una ''Base de API'' para todos mis proyectos de Eclipse Plugin.

Sin embargo, parece que no hay documentación que realmente explique qué significa ''API Baseline'' aquí, y para qué se usa.

¿Podría alguien explicar por favor?

Answer 1

De la Guía de usuario de las herramientas de PDE API :

Una línea de base de API define el estado con el que desea comparar los paquetes de su espacio de trabajo de desarrollo con fines de compatibilidad binaria, números de versión del paquete y etiquetas @since. Por ejemplo, si está desarrollando paquetes para Eclipse 3.4, usará Eclipse 3.3 como su línea base.

Answer 2

Eche un vistazo, puede ayudarlo a:

1. Herramientas API en Eclipse: una introducción

Answer 3

Los API Baseline están destinados a ayudarte a mantener complementos que otros puedan usar. Las herramientas de API te ayudan a crear versiones de API compatibles. Siga el enlace que Sumit Singh publicó para obtener una explicación sobre cómo usarlos.

El problema:

1. Usted crea su complemento y lanza la versión 1 al público.
2. Millones de personas usarán tu complemento y crearán su propio código que depende de la API de tu complemento.
3. Lanzas la versión 2 al público. Por error , cambias la API de tu complemento.
4. Millones de personas actualizan la nueva versión y tienen que adaptar su código. Miles de programas fallan. La gente está triste.

La solución:

1. Usted crea su complemento, anota su API y lanza la versión 1 al público.
2. Millones de personas usarán tu complemento y crearán su propio código que depende de la API de tu complemento.
3. Usted declara que la versión 1 de su complemento es la base de API con la que se comparan automáticamente sus cambios de código. Cualquier interrupción en la API se le presenta antes de lanzar su complemento o ejecutar sus pruebas. Lanza la versión 2 sin ningún cambio en la API.
4. Millones de personas pueden actualizar su complemento en su aplicación, porque la nueva versión del complemento es binaria compatible con la anterior.
5. Usted declara la versión 2 de su complemento ....

Resumen

Si desarrolla un complemento solo para su uso personal y no está interesado en mantener una API compatible, puede seguir los consejos para desactivar las advertencias.

Cuando desarrollas complementos para una comunidad, por ejemplo, los plugins de eclipse, es esencial que mantengas las incompatibilidades de la API al mínimo. Luego, seguirás los consejos y establecerás la línea de base en 4.2 cuando desarrolles para 4.3. Las herramientas API lo ayudarán a hacer de 4.3 un placer para todos los usuarios 4.2 actuales.

Tenga en cuenta que las herramientas API son para los desarrolladores de los complementos que otros usarán. No están dirigidos a los usuarios de esos complementos.