Ionic Debug Console
In-app javascript console for Ionic 2 applications with remote error tracking.
Installation
Run this command in root of your Ionic 2 project.
To install this library, run:
$ npm install ionic-debug-console --save
Then require the console library in app.ts.
;
Add Ionic Debug Console button directive to @Component
metadata in app.ts
:
Pass ConsoleDataProvider instance to @Component class constructor and init console with some config.
constructorprivate consoleDataProvider: cons.ConsoleDataProvider
Add Ionic Debug Console providers to ionicBootstrap function:
ionicBootstrapAppClass, , ;
Put console button component to @Component template in app.html
. Don`t forget pass content
.
Example application with integration described above:
https://github.com/lpikora/ionic-conference-app
Configuration
Configuration is pass as object with properties to init
function of ConsoleDataProvider
. For example:
this.consoleDataProvider.init;
When reporting set true
, some configuration values are load from server application settings. Values passed to init() function has always prioprity and rewrite application configuration from server.
- apiUrl - url of server running Ionic Debug Console Server
- apiToken - application accest token for server
- reporting - when
true
, logged data are sent to server. Defaultfalse
. - production - when
true
, console button will not show and console errors, logs and warns are disabled. Defaultfalse
. - communicationInterval - interval in
ms
for sending dat to server. Default value loads from server. - logErrors - when
true
, errors aer sent to server. Default value loads from server. - logWarnings - when
true
, console.warn output is sent to server. Default value loads from server. - logLogs - when
true
, console.log output is sent to server. Default value loads from server. - sendOnlyOnError - when
true
, console output is sent only if contains error. Default value loads from server.
Development
To generate all *.js
, *.js.map
and *.d.ts
files:
$ npm run tsc
Other repos
Ionic Debug Console Server
Ionic Debug Console server with REST API for error tracking.
https://github.com/lpikora/ionic-debug-console-backend-api
Ionic Debug Console Server UI
User interface for Ionic Debug Console Server. Provide managing apps and displaying tracked logs and errors.
https://github.com/lpikora/ionic-debug-console-backend-ui
Example app with Ionic Debug Console intergation
Example of Ionic Debug Console itegration in Ionic 2 app.
https://github.com/lpikora/ionic-conference-app
License
MIT © Lukas Pikora