🌜
🌞
cca

cca

v0.8.1

Run Chrome Apps on mobile using Apache Cordova

npm install cca

README

Create Chrome Apps for Mobile Using Apache Cordova

The Chrome Apps for Mobile Toolchain is no longer being actively developed. We intend to keep it functional, but do not intend on adding any new features.

A Chrome App running on both desktop and mobile

Overview

Chrome Apps for Mobile is a project based on Apache Cordova to run your Chrome Apps on both Android and iOS. The project provides a native application wrapper around your Chrome App, allowing you to distribute it via the Google Play Store and the Apple App Store. Cordova plugins give your App access to a wide range of APIs, including many of the core Chrome APIs. The newest version of Chrome Apps for Mobile includes Chrome APIs for identity, Google Cloud Messaging (GCM) and rich notifications.

For an overview and demo of hybrid development, Chrome Apps for Mobile, and our Chrome App Developer Tool for Mobile, check out our Google I/O Bytes video.

Chrome Apps on Android and iOS

Tools

Using CDE, cca, and CADT to develop Chrome Apps for Mobile

The cca Command Line Tool

cca provides all the functionality you need to develop and package Chrome Apps for Mobile from the command line. Use it with Chrome App Developer Tool (below) to rapidly iterate on your code: live deploy allows you to instantly see your Chrome App running on a connected mobile device. When you are ready to publish your Chrome App for Mobile to the Apple App Store and Google Play Store, use cca to bundle up your Chrome App into the proper mobile packages.

Chrome App Developer Tool for Mobile (CADT)

CADT is an app for your mobile development device that makes it quick and easy to see your code in action. It provides the Cordova framework of Chrome Apps for Mobile so you can test your code by simply pushing your Chrome App assets to your mobile device (made easy with our tools), which is must faster than packaging up the entire mobile app. This is called live deploy.

With CADT running on your mobile device, live deploy can be initiated from your development computer with either Chrome Dev Editor or the cca command line tool, allowing you to instantly preview the Chrome App you're editing, running right on Android or iOS. When you make a change to the code in your editor, you're a quick push away from seeing it straight on your device.

Chrome Dev Editor (CDE)

CDE is an IDE built specifically for Chrome Apps. Use it with CADT for live deploy.

Try it out

Try out Chrome Apps for Mobile by following these steps:

It's also a good idea to go through our codelab, where you will learn to use chrome.gcm and chrome.notifications to build a simple chat app.

Things to Know

  • The Chrome Apps for Mobile project is built on top of Apache Cordova, the open source mobile development framework for building mobile apps with native capabilities using HTML, CSS and JavaScript.

  • cca projects are Cordova projects.

  • By default, Chrome Apps built with cca use Crosswalk, (advantages and tradeoffs).

  • Most Cordova plugins that provide chrome.* APIs work with regular Cordova projects.

  • There is a List of Chrome App APIs that are supported on mobile.

  • For even more, see the FAQ.

Let's get started

Continue to Step 1: Install your development tools »

Release Notes

0.6.0
Published on March 24, 2015

Release Notes:

  • Updated cordova-android to use latest 4.0.0-dev version
  • Updated cordova-ios to 3.8.0 (Fixes exec() bridge <iframe> explosion bug)
  • Updated Crosswalk to version 11
  • Android now sets target-sdk=21 (Lollipop)
  • Content-Security-Policy now works and enabled by default (can be disabled though)
  • cca is now smarter about not adding iOS when building for Android (and vice-versa)
  • Pin major version of bootstrap, i18n, and navigation plugins (cca will no longer break when plugins are updated)
  • Generate <icon> within config.xml rather than copy files directly (Fixes iPhone 6+ issues)
  • Android builds now work the same when built via Android Studio vs. command-line
  • No longer rename _locales -> CCA_locales
  • Ignore <!-- html --> when parsing main page (fixes #510)
  • Add cca build --android-minSdkVersion flag
  • Add cca run --list to list available deploy targets
  • Add cca run --link to link rather than copy native source files (useful when developing plugins)
  • cca push now works on node 0.12
  • Don't build multi-arch apks when --webview=system is used.
  • Added "new version of cca available" logic via update-notifier module
  • New publishing instructions on how to use Crosswalk for pre-L Android, and system webview for L+

General

License
Apache-2.0
Typescript Types
None found
Tree-shakeable
No

Popularity

GitHub Stargazers
2,507
Community Interest
3,207
Number of Forks
412

Maintenance

Commits
10/219/2201
Last Commit
Nov 27, 2015
Open Issues
146
Closed Issues
364
Open Pull Requests
3
Closed Pull Requests
29

Versions

Versions Released
10/219/2201
Latest Version Released
Nov 17, 2015
Current Tags
latest0.8.1
rc0.8.0-rc3
nobundle0.0.3-nobundle

Contributors

agrieve
agrieve
Commits: 805
mmocny
mmocny
Commits: 526
clelland
clelland
Commits: 249
mwoghiren
mwoghiren
Commits: 180
oahziur
oahziur
Commits: 89
jpchase
jpchase
Commits: 83
shepheb
shepheb
Commits: 79
kamrik
kamrik
Commits: 58
beaufortfrancois
beaufortfrancois
Commits: 57
Thunderston3
Thunderston3
Commits: 18
jbwillms
jbwillms
Commits: 13
grahamkennery
grahamkennery
Commits: 3
mbodock
mbodock
Commits: 3
kzahel
kzahel
Commits: 2
mikaelkindborg
mikaelkindborg
Commits: 2