Construyendo la APK

Construyela tú mismo en lugar de descargarla

AndroidAPS no está disponible como descarga debido a la regulación de los dispositivos mediales. ¡Es legal construir la aplicación para su propio uso, pero no debe dar una copia a los demás! Consulte la página FAQ para obtener detalles.

Notas importantes

Configuración bajo demanda no está soportada por la versión actual del plugin de Gradle de Android!

Si la compilación falla con un error en la configuración personalizada, puede realizar lo siguiente:

  • Abra la ventana de Preferencias, haga clic en Archivo > Configuración (en Mac, Android Studio > Preferencias).
  • En el panel de la izquierda, pulse Compilar, Ejecución, Deployment > Compilador.
  • Desmarque la casilla de verificación Configurar bajo demanda.
  • Haga clic en Aplicar o en Aceptar.

Este artículo se divide en dos partes.

  • En la parte de descripción general hay una explicación sobre qué pasos son necesarios para crear el archivo APK.
  • En el paso paso a paso encontrará las capturas de pantalla de una instalación en concreto. Debido a que las versiones de Android Studio - el entorno de desarrollo de software que usaremos para construir el APK - cambia muy rápidamente hace que esta guía no será idéntica a su instalación, pero debería darte un buen punto de partida. Android Studio también se ejecuta en Windows, Mac OS X y Linux y es posible que haya pequeñas diferencias en algunos aspectos entre cada plataforma. If you find that something important is wrong or missing, please inform the facebook group “AndroidAPS users” or in the Discord chat Android APS so that we can have a look at this.

Tutorial paso a paso

Descripción detallada de los pasos necesarios para crear el archivo APK.

Instalar git (si no lo tienes ya)

Siga el manual en git página de instalación.

Instalar Android Studio

Las siguientes capturas de pantalla se han tomado de Android Studio Versión 3.6.1. Es posible que la pantalla parezca un poco diferente si utiliza una versión más reciente de Android Studio. Pero deberías ser capaz de encontrar el camino a través del proceso. Se proporciona ayuda de la comunidad.

One of the most important things when installing Android Studio: Be patient! During installation and setup Android Studio is downloading a lot of stuff which will take its time.

Instale Android Studio y configurelo durante el primer inicio.

Seleccione “No importar valores”, ya que no lo ha utilizado anteriormente.

No importar valores

Decida si desea compartir datos con Google o no.

Compartir datos con Google

En la siguiente pantalla, haga clic en “Next”.

Pantalla de bienvenida

Seleccione la instalación “Estándar” y haga clic en “Siguiente”.

Instalación estándar

Seleccione el tema para la interfaz de usuario que desee. (En este manual usamos “Light”.) Luego haga clic en “Next”. Este es sólo el esquema de colores. Usted puede seleccionar cualquier que le gusta (por ejemplo, “Darcula” para el modo oscuro). Esta selección no tiene ninguna influencia sobre la construcción del APK.

Esquema de color de IU

Pulse “Siguiente” en el diálogo “Verificar valores”.

Verificar la configuración

Espere mientras Android Studio descarga componentes adicionales y tenga paciencia. Una vez que todo se descarga el botón “Finalizar” se vuelve azul. Haga clic en el botón ahora.

Descarga de componentes

Establecer la ruta git en las preferencias

Asegúrese de que git esté instalado en el sistema.

En la pantalla de bienvenida de Android Studio, haga clic en el triángulo pequeño (1. en la siguiente captura de pantalla) y seleccione “Configuración” (2.).

Valores de Android Studio desde la pantalla de bienvenida

Windows

  • Haga clic en el triángulo pequeño junto a Control de versiones (1.) para abrir el submenú.

  • Haga clic en Git (2.).

  • Asegúrese de que el método de actualización “Merge” (3.) está seleccionado.

  • Compruebe si Android Studio puede localizar la ruta a git.exe automáticamente haciendo clic en el botón “Test” (4.)

    Ajustes de Android Studio

  • Si la configuración automática es correcta, se mostrará la versión git.

  • Haga clic en “Aceptar” en el cuadro de diálogo (1.) y en “Aceptar” en la ventana de configuración (2.).

    Instalación automática de git satisfactoria

  • En caso de archivo git.exe no se puede encontrar clic en “OK” en el cuadro de diálogo (1.) y luego el botón con los tres puntos (2.).

  • Utilice la función de búsqueda en el explorador de Windows para encontrar “git.exe” si no está seguro de dónde se encuentra. Está buscando git.exe ubicado en la carpeta \bin.

  • Seleccione la vía de acceso a git.exe y asegúrese de seleccionar la carpeta en ** \bin\ ** carpeta (3.) y haga clic en “Aceptar” (4.).

  • Cierre la ventana de configuración haciendo clic en el botón “Aceptar” (5.).

    Error en la instalación automática de git

  • Reinicie el sistema para actualizar el entorno del sistema.

Mac

  • Cualquier versión de git sirve. For example https://git-scm.com/download/mac.
  • Utilice homebrew para instalar git: $brew install git.
  • Para más detalles sobre la instalación de git, consulte la documentación oficial del git.
  • Si instala git a través de un homebrew, no es necesario cambiar ninguna preferencia. Solo por caso: se puedan encontrar aquí: Android Studio - Preferencias.

Descargar código de AndroidAPS

  • Si aún no ha reiniciado su equipo después de configurar la ruta de git en las preferencias, hágalo ahora. El entorno del sistema debe actualizarse.

  • There are two options to start a new project:

    • On the Android Studio welcome screen click “Get from version control”

      Revisa el proyecto desde el control de versiones desde la pantalla de bienvenida

    • If you already opened Android Studio and do not see the welcome screen anymore select File (1.) > New (2.) > Project from Version Control... (3.)

      Check out project from version control within Android Studio

  • Fill in the URL to the main AndroidAPS repository (https://github.com/nightscout/AndroidAPS) (1.).

  • Elija el directorio en el que desea guardar el código clonado. (2.)

  • Haga clic en el botón “Clonar” (3.).

    Clonar repositorio

  • Do not click “Background” while repository is cloned!

    No background action

  • After repository is cloned successfully open your local copy by clicking “Yes”.

    Abrir repositorio

  • In the lower right corner you will see the information that Android Studio is running background tasks.

    Tareas en segundo plano

  • Grant access if your firewall is asking for permission.

    Permiso de cortafuegos java

  • Once the background tasks are finished you will probably see the following error message:

    Licencia SDK

Descargar Android SDK

  • Haga clic en Archivo > Configuración.

    Abrir ajustes

  • Click the small triangle next to Appearance & Behaviour (1.).

  • Click the small triangle next to System Settings (2.) and select Android SDK (3.)

  • Check the box left of “Android 9.0 (Pie)” (4.) (API Level 28).

    Ajustes de SDK

  • Confirme los cambios pulsando Aceptar.

    Confirmar cambios de SDK

  • Acepte el acuerdo de licencia (1.) y haga clic en “Next” (2.).

    Aceptar licencia SDK

  • Espere hasta que termine la instalación.

    Espere durante la instalación de SDK

  • Cuando se complete la instalación de SDK el botón “Finalizar” se volverá azul. Pulse el botón.

    Finalizar la instalación del SDK

  • Android Studio might recommend to update the gradle system. Never update gradle! This might lead to difficulties!

  • If you see an information on the lower right side of your Android Studio window that Android Gradle Plugin is ready to update click on the text “update” (1.) and in the dialog box on “Don’t remind me again for this project” (2.).

    No cradle update

Generar APK firmado

Signing means that you indicate your app to be your own creation but in a digital way as a kind of digital fingerprint within the app itself. Esto es necesario porque Android tiene una regla que sólo acepta el código firmado para ejecutarse por razones de seguridad. Para obtener más información sobre este tema, siga este enlace.

  • Click “Build” in the menu bar and select “Generate Signed Bundle / APK...”.

    Crear apk

  • Seleccione “APK” (1.) en lugar de “Android App Bundle” y haga clic en “Next” (2.).

    APK instead of bundle

  • Make sure that module is set to “app” (1.).

  • Click “Create new...” (2.) to start creating your key store.

    A key store in this case is nothing more than a file in which the information for signing is stored. Está encriptado y la información está protegida con contraseñas.

    Create key store

  • Click the folder symbol (1.) to select your key store path.

  • Select the path where your key store shall be saved (2.). Do not save in same folder as project. You must use a different directory! One option might be your home folder.

  • Type a file name for your key store (3.).

  • Click “OK” (4.).

  • Passwords for key store and key do not have to be very sophisticated. Make sure to remember those or make a note in a safe place. In case you will not remember your passwords in the future you see troubleshooting for lost key store.

  • Enter (5.) and confirm (6.) the password for your key store.

  • Do the same for your key (7. + 8.).

  • Validity (9.) is 25 years by default. You do not have to change the default value.

  • First and last name must be entered (10.). All other information is optional.

  • Click “OK” (11.) when you are done.

    Ruta de almacén de claves

  • Make sure the box to remember passwords is checked (1.). So you don’t have to enter them again next time you build the apk (i.e. when updating to a new AndroidAPS version).

  • Haga clic en “Next” (2.).

    Recordar contraseñas

  • Seleccione la variante de compilación “fullRelease” (1.).

  • Marque las casillas V1 y V2 para las versiones de firma (2.).

  • Haga clic en “Finalizar”. (3.)

    Finalizar construcción

  • Android Studio mostrará la información “APK(s) generados con éxito...” una vez finalizada la compilación.

  • En caso de que la compilación no fuera exitosa, consulte la sección solución de problemas.

  • Easiest way to find the apk is to click on “Event log”.

    Build successfully - event log

  • In the event log section click “locate”.

    Event log - locate apk

  • app-full-release.apk is the file you are looking for.

    File location apk

Transferir APK a smartphone

Easiest way to transfer app-full-release.apk to your phone is via USB cable or Google Drive. Please note that transfer by mail might cause difficulties and is not the preferred way.

On your phone you have to allow installation from unknown sources. Manuals how to do this can be found on the internet (i.e. here or here).

Identificar receptor si se utiliza xDrip+

See xDrip+ page

Solución de problemas

Consulte la página separada para la resolución de problemas de Android Studio.