Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/egamagz/viajevidaar
Aplicación de Realidad aumentada complementaría a recorrido virtual "museo de la vida"
https://github.com/egamagz/viajevidaar
alpinejs angular arjs htmx ionic threejs
Last synced: 7 days ago
JSON representation
Aplicación de Realidad aumentada complementaría a recorrido virtual "museo de la vida"
- Host: GitHub
- URL: https://github.com/egamagz/viajevidaar
- Owner: EGAMAGZ
- Created: 2023-09-12T22:55:57.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-01-21T00:29:13.000Z (about 1 year ago)
- Last Synced: 2024-11-21T00:43:01.883Z (2 months ago)
- Topics: alpinejs, angular, arjs, htmx, ionic, threejs
- Language: TypeScript
- Homepage:
- Size: 43.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Viaje de la Vida AR
Aplicacion android complemento de ["Viaje de la Vida"](https://github.com/EGAMAGZ/ViajeDeLaVida).
## Requerimientos
| Tecnologia | Version | Link |
|------------|---------|------|
| Node | 20.1.0 o mayor | [Pagina](https://nodejs.org/en)|
| Git | Cualquier | [Pagina](https://git-scm.com/)|
| Android Studio (En caso de ejecutar en android) | Giraffe 2022.3.1 o menor | [Pagina](https://developer.android.com/studio)|## Descarga de proyecto
Para descargar el proyecto se puede realizar de dos maneras:
* Clonar el repositorio desde GitHub
Es necesario tener instalado git, para corroborar si se tiene instalado git, se puede ejecutar el siguiente comando en la terminal:
```bash
git --version
```El cual devolvera la version de git instalada, por ejemplo:
![Captura de git](./screenshots/captura-git.png)
Para descargar el proyecto con Git, se realiza clonando el repositorio desde GitHub ejecutando el siguiente comando en la terminal:
```bash
git clone https://github.com/EGAMAGZ/ViajeVidaAR.git
```Dicho comando, creara un nuevo directorio en la ruta del proyecto, el cual se llamara `ViajeVidaAR` en la ruta actual en la terminal. Ejemplo:
![Captura de git](./screenshots/captura-git-clone.png)
* Descargar el zip del proyecto
Para descargar el zip del proyecto se es necesario ir al [repositorio](https://github.com/EGAMAGZ/ViajeVidaAR) y dar click en `Code > Download ZIP`:
![Captura de github](./screenshots/captura-github.png)
## Instalación de dependencias
Una vez que se tiene clonado el repositorio o descargado el zip, nos redirecionaremos a la carpeta `ViajeVidaAR` en la terminal:
```bash
cd ViajeVidaAR
```Y para las dependencias del projecto se debe realizar el siguiente comando en la terminal:
```bash
npm install
```Ejemplo:
![Captura de npm](./screenshots/captura-npm.png)
## Ejecución
### Escritorio
Para ejecutar el proyecto se debe realizar el siguiente comando en la terminal:
```bash
npm start
```Una vez que se ejecute el proyecto, se genera el proyecto y abira el navegador una vez terminado.
### Android
Para ejecutar el proyecto en Android, se debe compilar el proyecto (web) con el siguiente comando:
```bash
npx ionic build --configuration=production && npx cap copy
```Una vez terminada la compilación, se necesita sincronizar el proyecto con el dispositivo. Para hacerlo, se debe realizar el siguiente comando en la terminal:
```bash
npx cap sync --inline
```Una vez terminada la sincronización, se debe de abrir el proyecto, la carpeta `android` que encontramos en el proyecto, en Android Studio.
![Captura de Android Studio](./screenshots/captura-android-1.png)
![Captura de Android Studio](./screenshots/captura-android-2.png)
![Captura de Android Studio](./screenshots/captura-android-3.png)Al abrir el proyecto, este empezara a instalar las librerias e indexar el proyecto. Una vez que termine el proceso, se nos habilitara el panel superior para la ejecución y debug de la aplicación.
![Captura de Android Studio](./screenshots/captura-android-4.png)
Una vez todo esto, conectamos nuestro dispositivo a la computadora (y aceptamos el permiso de USB Debugging que nos mostrará en el dispositivo Android). Cuando el nombre de nuestro dispositivo en el superior, ejecutamos el proyecto, el cual instalará y abrira la aplicación en el dispositivo.
![Captura de Android Studio](./screenshots/captura-android-5.png)
*NOTA:* Es necesario que nuestro telefono tenga activada la funcionalidad de USB Debugging. [Tutorial para activar USB Debugging](https://youtube.com/shorts/p7DDuq56suU?si=2yxmXH1cOhAu1tap)
*NOTA:* Es necesario que nuestro telefono tenga conexión a internet al ejecutar el proyecto.
## Recursos (extras)
[Marcador por defecto (para pruebas)](https://jeromeetienne.github.io/AR.js/data/images/HIRO.jpg)