Browse Source

Migrate guide.

Herbert Vojčík 11 years ago
parent
commit
d370636434
1 changed files with 24 additions and 1 deletions
  1. 24 1
      CHANGELOG

+ 24 - 1
CHANGELOG

@@ -69,11 +69,34 @@ To install Amber from Bower, run
 
 * Migration from Amber 0.11.0
 
+First, you must change loading part. The proprietary loader is gone,
+you have to use requirejs for loading. New loader code is thouroughly
+explained in [4].
+
+After changing the loader part, you need to recompile all your `.st` files
+into new AMD `.js` files. During loader changes, you had to choose a namespace,
+this will be needed now.
+
+Go to your directory with `.st` files and issue this from the shell:
+
+```sh
+<path-to-amber>/bin/amberc -l SUnit,Canvas -n <the-namespace-you-have-chosen> -D <path-for-compiled-js-files> *.st
+```
+
+In windows, use `\` as path separator, the rest is identical.
+
+The `-l SUnit,Canvas` is just a general guess, if your code depends on more (or less) non-kernel packages from amber, list them here accordingly.
+
+This migrate scenario only covers simple deployments with your project's code and amber.
+If your project is more compilicated, using libraries and packages from multiple sources,
+it is hard to give general advices to migrate - you must do it library by library,
+giving each location its own namespace, and `-L` option of `amberc`
+comes handy when integrating; ask on the mailing list if problems arise.
 
 [1] http://requirejs.org/
 [2] http://bower.io/
 [3] https://github.com/amber-smalltalk/brikz
-
+[4] https://github.com/amber-smalltalk/amber/wiki/How-to-load-amber
 
 
 09th July 2013 - Release 0.11.0