Antes de nada, hay que instalar Python 2 en caso de no tenerlo instalado en el sistema, aunque tengamos instalada una versión más reciente como por ejemplo Python 3.
sudo apt install python2
Creamos un proyecto en blanco:
ionic start exercise01a blank --type=ionic1
La creación del proyecto podría provocar errores relativos al CSS. En tal caso, habría que instalar node-sass
, borrar el directorio node_modules
y actualizar las dependencias:
cd exercise01a
npm install node-sass
rm -Rf node_modules
npm install
No sería de extrañar que se siguieran produciendo errores. Ionic 1 ya es muy antiguo y hace uso de librerías obsoletas. Esto no va a afectar en ningún modo a los proyectos que realicemos con versiones modernas de este framework.
Si el proyecto se ha creado correctamente, se puede lanzar el servidor:
ionic serve
Estructura de directorios y ficheros:
exercise01a
├── bower.json
├── gulpfile.js
├── hooks
│ ├── after_prepare
│ └── README.md
├── ionic.config.json
├── ionic.starter.json
├── node_modules
│ │
. .
. .
. .
├── package.json
├── package-lock.json
├── scss
│ └── ionic.app.scss
└── www
├── css
├── img
├── index.html
├── js
├── lib
├── manifest.json
└── service-worker.js
Como se puede observar, en un proyecto de la versión 1 de Ionic, el grueso de la aplicación está en la carpeta www
. Dentro de ese directorio está index.html
que hace las veces de plantilla HTML.
La lógica de negocio estaría contenida dentro de la carpeta js
, los estilos en la carpeta css
y las imágenes en img
.
Se trata de una estructura muy simple, parecida a lo que sería un proyecto de HTML con Javascript sin ningún framework.
En Ionic 1 se utiliza AngularJS (versión 1.X). Cuando se liberó esta versión de Ionic, todavía no existía Angular a secas (versión 2+), por tanto, la lógica de negocio se programaba directamente en Javascript.
Creación del proyecto:
ionic start exercise01b blank --type=ionic-angular
Estructura de directorios y ficheros:
exercise01b
├── ionic.config.json
├── node_modules
. .
. .
. .
├── package.json
├── package-lock.json
├── src
│ ├── app
│ ├── assets
│ ├── index.html
│ ├── manifest.json
│ ├── pages
│ ├── service-worker.js
│ └── theme
├── tsconfig.json
├── tslint.json
└── www
├── assets
├── build
├── index.html
├── manifest.json
└── service-worker.js
Como podemos comprobar, hay más diferencias que similitudes en la estructura de directorios de un proyecto de la versión 2/3 con respecto a otro de la versión 1.
En esta versión, el código fuente de la aplicación está en la carpeta src
mientras que en la carpeta www
se colocará el código de la aplicación una vez compilada, lista para su despliegue.
Si indagamos un poco dentro del directorio app
o en pages
(donde se encuentra la página principal que viene por defecto) encontraremos archivos con la extensión .ts
. Estos archivos contienen código en Typescript, lo que nos da una pista que nos indica que estamos ya ante un proyecto en el que se usa Angular y no AngularJS.
Creación del proyecto:
ionic start exercise01c blank --type=angular
Estructura de directorios y ficheros:
exercise01c
├── angular.json
├── browserslist
├── e2e
│ ├── protractor.conf.js
│ ├── src
│ └── tsconfig.json
├── ionic.config.json
├── karma.conf.js
├── node_modules
│ ├── abab
. .
. .
. .
│ └── zone.js
├── package.json
├── package-lock.json
├── src
│ ├── app
│ ├── assets
│ ├── environments
│ ├── global.scss
│ ├── index.html
│ ├── main.ts
│ ├── polyfills.ts
│ ├── test.ts
│ ├── theme
│ └── zone-flags.ts
├── tsconfig.app.json
├── tsconfig.json
├── tsconfig.spec.json
└── tslint.json
En la versión 4+, a primera vista, hay más carpetas y archivos que en la versión 2/3.
Desaparece la carpeta www
por defecto. Esta carpeta y su contenido se generará cuando se compile la aplicación con ionic build
.
La carpeta pages
también desaparece en esta versión, aunque se puede crear manualmente para guardar las páginas de la aplicación si se quiere.
www/index.html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
<title></title>
<link rel="manifest" href="manifest.json">
<!-- un-comment this code to enable service worker
<script>
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('service-worker.js')
.then(() => console.log('service worker installed'))
.catch(err => console.log('Error', err));
}
</script>-->
<link href="lib/ionic/css/ionic.css" rel="stylesheet">
<link href="css/style.css" rel="stylesheet">
<!-- IF using Sass (run gulp sass first), then uncomment below and remove the CSS includes above
<link href="css/ionic.app.css" rel="stylesheet">
-->
<!-- ionic/angularjs js -->
<script src="lib/ionic/js/ionic.bundle.js"></script>
<!-- cordova script (this will be a 404 during development) -->
<script src="cordova.js"></script>
<!-- your app's js -->
<script src="js/app.js"></script>
</head>
<body ng-app="starter">
<ion-pane>
<ion-header-bar class="bar-stable">
<h1 class="title">Ionic Blank Starter</h1>
</ion-header-bar>
<ion-content>
¡Hola mundo!
</ion-content>
</ion-pane>
</body>
</html>
src/app/pages/home/home.html
<ion-header>
<ion-navbar>
<ion-title>
Ionic Blank
</ion-title>
</ion-navbar>
</ion-header>
<ion-content padding>
¡Hola mundo!
</ion-content>
src/app/home/home.page.html
<ion-header [translucent]="true">
<ion-toolbar>
<ion-title>
Blank
</ion-title>
</ion-toolbar>
</ion-header>
<ion-content [fullscreen]="true">
<div id="container">
¡Hola mundo!
</div>
</ion-content>
En todas las versiones de Ionic se usa HTML como lenguaje de marcado para las vistas. En cuanto al lenguaje de programación que se utiliza para la lógica de negocio, en Ionic 1 se usaba Javascript y a partir de Ionic 2 se usa Typescript.
En un proyecto de Ionic 1 recién creado no hay ningún fichero específico para indicar las rutas ni hay definidas rutas por defecto en ningún lugar.
A continuación se muestra un ejemplo de definición de rutas en el archivo app.js
(extraido de https://github.com/ionic-team/ionic-migration-demo-v1):
.config(function($stateProvider, $urlRouterProvider) {
// Ionic uses AngularUI Router which uses the concept of states
// Learn more here: https://github.com/angular-ui/ui-router
// Set up the various states which the app can be in.
// Each state's controller can be found in controllers.js
$stateProvider
// setup an abstract state for the tabs directive
.state('tab', {
url: '/tab',
abstract: true,
templateUrl: 'templates/tabs.html'
})
// Each tab has its own nav history stack:
.state('tab.feed', {
url: '/feed',
views: {
'tab-feed': {
templateUrl: 'templates/tab-feed.html',
controller: 'FeedCtrl'
}
}
})
.state('tab.chats', {
url: '/chats',
views: {
'tab-chats': {
templateUrl: 'templates/tab-chats.html',
controller: 'ChatsCtrl'
}
}
})
.state('tab.chat-detail', {
url: '/chats/:chatId',
views: {
'tab-chats': {
templateUrl: 'templates/chat-detail.html',
controller: 'ChatDetailCtrl'
}
}
})
.state('tab.account', {
url: '/account',
views: {
'tab-account': {
templateUrl: 'templates/tab-account.html',
controller: 'AccountCtrl'
}
}
});
// if none of the above states are matched, use this as the fallback
$urlRouterProvider.otherwise('/tab/feed');
});
Sigue sin haber un fichero específico para definir el enrutamiento. Las rutas se añaden en los imports
de @NgModule
del archivo src/app/appmodule.ts
(fuente: http://blog.enriqueoriol.com/2017/01/ionic-deeplinker-ii-urls-y-tabs.html):
//src/app/app.module.ts
//...some stuff...
@NgModule({
//...more stuff...
imports: [
IonicModule.forRoot(MyApp, {}, {
links:[
{segment:'home', component:HomePage, name: 'Home Page'},
{segment:'contact', component:ContactPage, name: 'Contact Page'},
{segment:'about', component:AboutPage, name: 'About Page'}
]
})
],
//...more stuff...
})
export class AppModule {}
Ionic pasa a usar el mismo enrutamiento de Angular. Ahora sí que existe un archivo exclusivo para las rutas, se trata de src/app/app-routing.module.ts
. En un proyecto nuevo, ese fichero tiene el siguiente código:
import { NgModule } from '@angular/core';
import { PreloadAllModules, RouterModule, Routes } from '@angular/router';
const routes: Routes = [
{
path: 'home',
loadChildren: () => import('./home/home.module').then( m => m.HomePageModule)
},
{
path: '',
redirectTo: 'home',
pathMatch: 'full'
},
];
@NgModule({
imports: [
RouterModule.forRoot(routes, { preloadingStrategy: PreloadAllModules })
],
exports: [RouterModule]
})
export class AppRoutingModule { }
⭐ Si te ha gustado este repo, dale una estrellita 😉