scripts/sdks/README.md

   1 # SDKs management scripts
   2
   3 To support a new SDK family, you must create a new directory under
   4 `scripts/sdk/xxx` where xxx is the new SDK family.
   5
   6 Then you must create the following scripts (or executable) :
   7
   8 - `add`: add a new SDK
   9 - `db-dump`: returned the list of available SDKs (JSON format)
  10 - `db-update`: update SDKs database
  11 - `get-family-config`: returned SDK family configuration structure (JSON format)
  12 - `get-sdk-info`: extract SDK info (JSON format) from a SDK file/tarball
  13 - `remove`: remove an existing SDK
  14
  15 ## `add`
  16
  17 add a new SDK
  18
  19 This script returns code 0 when sdk is successfully installed, else returns an
  20 error code.
  21
  22 List of parameters to implement:
  23
  24 - `-f|--file <filepath>` :  install a SDK using a file
  25 - `--force`:                force SDK install when a SDK already in the same destination directory
  26 - `-u|--url <url>` :        download SDK using this URL and then install it
  27 - `-no-clean` :             don't cleanup temporary files
  28 - `-h|--help` :             display help
  29
  30 ## `db-dump`
  31
  32 Returned the list all SDKs (available and installed) using JSON format.
  33
  34 ```json
  35 [
  36   {
  37     "name":         "My SDK name",
  38     "description":  "A description",
  39     "profile":      "profile",
  40     "version":      "version",
  41     "arch":         "architecture",
  42     "path":         "path where sdk installed locally",
  43     "url":          "https://website.url.to.download.sdk",
  44     "status":       "Not Installed | Installed",
  45     "date":         "2017-12-25 00:00",
  46     "size":         "123 MB",
  47     "md5sum":       "123456789",
  48     "setupFile":    "path to file to setup SDK environment"
  49   }, {
  50     "name":         "My SDK name 2",
  51     "description":  "A description 2",
  52     ...
  53   }
  54   ...
  55 ]
  56 ```
  57
  58 ## `db-update`
  59
  60 Update sdk database that may be used by `list` command.
  61
  62 ## `get-family-config`
  63
  64 Returned SDK configuration as JSON format:
  65
  66 ```json
  67 {
  68     "familyName": "xxx",
  69     "description": "bla bla",
  70     "rootDir": "/yyy/zzz",
  71     "envSetupFilename": "my-envfilename*",
  72     "scriptsDir": "scripts_path"
  73 }
  74 ```
  75
  76 where:
  77
  78 - `familyName` : sdk familyName (usually same name used as xxx directory)
  79 - `rootDir` : root directory where SDK are/will be  installed
  80 - `envSetupFilename` : sdk files (present in each sdk) that will be sourced to
  81   setup sdk environment
  82
  83 ## `get-sdk-info`
  84
  85 Extract SDK info, such as name, version, ... from a SDK tarball file (when
  86 --file option is set) or from a url (when --url option is set).
  87
  88 This script may also be used to check that a SDK tarball file is correct in
  89 order to determine for example that the SDK family.
  90
  91 List of parameters to implement:
  92
  93 - `-f|--file <filepath>` :  SDK tarball file used to get SDK info
  94 - `-u|--url <url>` :        url link used to get SDK info
  95 - `--md5` :                 md5sum value used to validate SDK tarball file
  96 - `-h|--help` :             display help
  97
  98 This script returns an error (value different from 0) and potential print an
  99 error message. Else when info are successfully extracted, this script must
 100 returned the following JSON structure:
 101
 102 ```json
 103 {
 104     "name":         "My SDK name",
 105     "description":  "A description",
 106     "profile":      "profile",
 107     "version":      "version",
 108     "arch":         "architecture",
 109     "path":         "",
 110     "url":          "https://website.url.to.download.sdk",
 111     "status":       "Not Installed",
 112     "date":         "2017-12-25 00:00",
 113     "size":         "123 MB",
 114     "md5sum":       "123456789",
 115     "setupFile":    "path to file to setup SDK environment"
 116 }
 117 ```
 118
 119 ## `remove`
 120
 121 Remove an existing SDK
 122
 123 The first argument is the full path of the directory of the SDK to removed.