AppSuite:Upgrading themes to 7 6: Difference between revisions

From Open-Xchange
Line 10: Line 10:
# First time: Clone the git repository, e.g. ''git clone https://git.open-xchange.com/git/foo''. Make sure you're in the proper branch (''git checkout branch-name''). Don't forget to git pull.
# First time: Clone the git repository, e.g. ''git clone https://git.open-xchange.com/git/foo''. Make sure you're in the proper branch (''git checkout branch-name''). Don't forget to git pull.
# First time: Run '''npm install'''
# First time: Run '''npm install'''
# Run '''grunt connect watch'''. If you already have a local grunt config for this repository, you're done. Otherwise you will be notified that '''coreDir''' is not configured. Grunt will offer you a command to get a basic grunt config (see next step)-
# Run '''grunt watch'''. If you already have a local grunt config for this repository, you're fine. Otherwise you will be notified that '''coreDir''' is not configured. Grunt will offer you a command to get a basic grunt config (see next step).
# Run '''grunt show-config:local --output grunt/local.conf.json'''
# If config is missing:
# Edit grunt/local.conf.json to have a proper '''coreDir'''. Just enter the absolute path to ''ui/build'' of the core UI. Also enter a running '''server'''.
## Run '''grunt show-config:local --output grunt/local.conf.json'''
# Run '''grunt connect watch''' again.
## Edit grunt/local.conf.json to have a proper '''coreDir'''. Just enter the absolute path to ''ui/build'' of the core UI.
# You have two alternatives now:
## Run against an existing server. Just run **grunt connect watch** now. Please mind to enter a valid server in your local conf.
## Run your own local server. Switch to core UI folder. Enter the theme's repository to "prefixes" array in grunt/local.conf.json. Absolute path including "build", e.g. ''/Users/foofoo/git/repo/great-themes/build''. Now run **grunt connect watch**.

Revision as of 08:47, 1 July 2014

Upgrading themes to 7.6

This article guides through the mandatory steps to update themes from 7.4.x to 7.6.0. It's does not cover what is necessary to migrate to the new build system.

Prerequisite

You need a built core UI! See Getting Started With Grunt. In a nutshell: git clone repository, setup (npm install, local config etc.), and build with grunt.

Steps

  1. First time: Clone the git repository, e.g. git clone https://git.open-xchange.com/git/foo. Make sure you're in the proper branch (git checkout branch-name). Don't forget to git pull.
  2. First time: Run npm install
  3. Run grunt watch. If you already have a local grunt config for this repository, you're fine. Otherwise you will be notified that coreDir is not configured. Grunt will offer you a command to get a basic grunt config (see next step).
  4. If config is missing:
    1. Run grunt show-config:local --output grunt/local.conf.json
    2. Edit grunt/local.conf.json to have a proper coreDir. Just enter the absolute path to ui/build of the core UI.
  5. You have two alternatives now:
    1. Run against an existing server. Just run **grunt connect watch** now. Please mind to enter a valid server in your local conf.
    2. Run your own local server. Switch to core UI folder. Enter the theme's repository to "prefixes" array in grunt/local.conf.json. Absolute path including "build", e.g. /Users/foofoo/git/repo/great-themes/build. Now run **grunt connect watch**.