README.md

   1 # spec2yocto
   2
   3 ## Installation
   4
   5 ### Define the YOCTO_WORKDIR environment variable:
   6
   7         export YOCTO_WORKDIR=<path_to_your_workdir>
   8
   9 ### Set up that work dir in which you clone the scm/bb/tizen repository:
  10
  11         mkdir -p $YOCTO_WORKDIR
  12         cd $YOCTO_WORKDIR
  13         git clone ssh://review.tizen.org:29418/scm/bb/tizen
  14
  15 ### Copy .spec2yoctorc to your home directory
  16
  17         cp tizen/proto-meta-Tizen_generic/spec2yoctorc ~/.spec2yoctorc
  18
  19 ### When using it unmodified, run spec2yocto only in the top-level "tizen" directory
  20 ### because some of the config files are found via relative paths.
  21
  22 ### Create a symbolic link to spec2yocto.py in a directory of your ${PATH}
  23
  24         ln -sf ${YOCTO_WORKDIR}/tizen/tools/spec2yocto.py
  25
  26 You can, of course, replace the "~/bin" with another directory of your choice.
  27
  28 ### Ensure that spec2yocto.py can find cmdln.py, for example from mic:
  29
  30         <install Tizen mic>
  31         ln -s /usr/share/pyshared/mic/utils/cmdln.py ${YOCTO_WORKDIR}/tizen/tools/
  32
  33 ### Create a spec2yocto directory in /usr/share
  34
  35         sudo mkdir /usr/share/spec2yocto
  36
  37 ### Create a symbolic link to proto-meta-Tizen_generic/rpm_tizen_macro/ in /usr/share/spec2yocto/macro
  38
  39         sudo ln -sf ${YOCTO_WORKDIR}/tizen/proto-meta-Tizen_generic/rpm_tizen_macro/ /usr/share/spec2yocto/macro
  40
  41 ## Usage
  42
  43 ### Execute gitCloneAll.sh (optional)
  44
  45 This project already contains all the necessary spec files to generate the recipes however those
  46 spec files may not be the most recent ones. If you want to generate the recipes from the latest spec
  47 files you can use this command which will clone all the tizen projects used in the Tizen Yocto
  48 images (note that it will take a while):
  49
  50         ./tizen/tools/gitCloneAll.sh
  51
  52 Alternatively you can also fetch a specific project:
  53
  54         ./tizen/tools/gitCloneAll.sh <project-name>
  55
  56 <project-name> has to be listed in the .spec2yoctorc. Check with
  57
  58         spec2yocto manifestToList | grep <project-name>
  59
  60 ## Using spec2yocto
  61
  62 For example, to generate the recipes:
  63
  64         spec2yocto createRecipes
  65
  66 For more commands, you can display the help:
  67
  68         spec2yocto -h
  69
  70 ## License
  71
  72 GPL v2
  73