toolsetup:buildingapackagelocally
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| toolsetup:buildingapackagelocally [2022/02/15 23:26] – f2b216 | toolsetup:buildingapackagelocally [2025/10/08 00:48] (current) – external edit 127.0.0.1 | ||
|---|---|---|---|
| Line 3: | Line 3: | ||
| ===== Use case ===== | ===== Use case ===== | ||
| - | You want to use the original sources, to modify | + | One wants to use the original sources |
| - | ===== Procedure | + | ===== Procedures |
| - | * in the project folder type: | + | We can choose out of the following two opportunities: |
| + | * | ||
| + | * with use of tarball files | ||
| + | ==== Procedure without tarball files ==== | ||
| + | |||
| + | * unpack the package that should be obtained as source code | ||
| * command:< | * command:< | ||
| + | stack unpack random | ||
| + | </ | ||
| + | * or command with dedicated version number:< | ||
| + | stack unpack random-1.2.1 | ||
| + | </ | ||
| + | * output:< | ||
| + | Unpacked random (from Hackage) to C: | ||
| + | </ | ||
| + | |||
| + | * change the current directory | ||
| + | * command:< | ||
| + | cd random-1.2.1 | ||
| + | </ | ||
| + | |||
| + | * initialise the folder of the package (here `random-1.2.1`), | ||
| + | * command:< | ||
| + | stack init | ||
| + | </ | ||
| + | * output:< | ||
| + | Looking for .cabal or package.yaml files to use to init the project. | ||
| + | Using cabal packages: | ||
| + | - .\ | ||
| + | |||
| + | Selecting the best among 20 snapshots... | ||
| + | |||
| + | * Matches https:// | ||
| + | |||
| + | Selected resolver: https:// | ||
| + | Initialising configuration using resolver: https:// | ||
| + | Total number of user packages considered: 1 | ||
| + | Writing configuration to file: stack.yaml | ||
| + | All done. | ||
| + | </ | ||
| + | |||
| + | * change the current directory back to the main one | ||
| + | * command:< | ||
| + | cd .. | ||
| + | </ | ||
| + | |||
| + | * to `stack.yaml` of main project, add package with relative path (here `./ | ||
| + | |||
| + | * extract< | ||
| + | # - auto-update | ||
| + | # - wai | ||
| + | packages: | ||
| + | - . | ||
| + | - ./ | ||
| + | |||
| + | # Dependency packages to be pulled from upstream that are not in the resolver. | ||
| + | # These entries can reference officially published versions as well as | ||
| + | </ | ||
| + | |||
| + | * to `package.yaml` of main project add dependency to package (here `random`) with constraint (here ` == 1.2.1`) to section `dependencies` | ||
| + | * extract< | ||
| + | . | ||
| + | . | ||
| + | . | ||
| + | # common to point users to the README.md file. | ||
| + | description: | ||
| + | |||
| + | dependencies: | ||
| + | - base >= 4.7 && < 5 | ||
| + | - random == 1.2.1 | ||
| + | |||
| + | library: | ||
| + | source-dirs: | ||
| + | . | ||
| + | . | ||
| + | . | ||
| + | </ | ||
| + | |||
| + | * delete cabal-file (here `Test7.cabal`), | ||
| + | |||
| + | * build the main project | ||
| + | * command:< | ||
| + | stack build | ||
| + | </ | ||
| + | * output:< | ||
| + | random> configure (lib) | ||
| + | random> Configuring random-1.2.1... | ||
| + | random> build (lib) | ||
| + | random> Preprocessing library for random-1.2.1.. | ||
| + | random> Building library for random-1.2.1.. | ||
| + | random> copy/ | ||
| + | random> Installing library in C: | ||
| + | random> Registering library for random-1.2.1.. | ||
| + | Building all executables for `Test7' | ||
| + | Test7 > configure (lib + exe) | ||
| + | Test7 > Configuring Test7-0.1.0.0... | ||
| + | Test7 > build (lib + exe) | ||
| + | Test7 > Preprocessing library for Test7-0.1.0.0.. | ||
| + | Test7 > Building library for Test7-0.1.0.0.. | ||
| + | Test7 > [1 of 2] Compiling Lib | ||
| + | Test7 > [2 of 2] Compiling Paths_Test7 | ||
| + | Test7 > Preprocessing executable ' | ||
| + | Test7 > Building executable ' | ||
| + | Test7 > [1 of 2] Compiling Main | ||
| + | Test7 > [2 of 2] Compiling Paths_Test7 | ||
| + | Test7 > Linking .stack-work\dist\274b403a\build\Test7-exe\Test7-exe.exe ... | ||
| + | Test7 > copy/ | ||
| + | Test7 > Installing library in C: | ||
| + | Test7 > Installing executable Test7-exe in C: | ||
| + | Test7 > Registering library for Test7-0.1.0.0.. | ||
| + | Completed 2 action(s). | ||
| + | </ | ||
| + | |||
| + | ==== Procedure with tarball files ==== | ||
| + | |||
| + | * unpack the package that should be obtained as source code | ||
| + | * command:< | ||
| + | stack unpack random | ||
| + | </ | ||
| + | * or command with dedicated version number:< | ||
| stack unpack random-1.2.1 | stack unpack random-1.2.1 | ||
| </ | </ | ||
| Line 15: | Line 133: | ||
| </ | </ | ||
| - | * ... | + | * change the current directory |
| * command:< | * command:< | ||
| cd random-1.2.1 | cd random-1.2.1 | ||
| </ | </ | ||
| - | * ... | + | * initialise the folder of the package (here `random-1.2.1`), will create file `stack.yaml` |
| * command:< | * command:< | ||
| stack init | stack init | ||
| Line 40: | Line 158: | ||
| </ | </ | ||
| - | * ... | + | * generate a tarball file of the package code |
| * command:< | * command:< | ||
| stack sdist | stack sdist | ||
| Line 55: | Line 173: | ||
| </ | </ | ||
| - | * ... | + | * change the current directory back to the main one |
| * command:< | * command:< | ||
| cd .. | cd .. | ||
| </ | </ | ||
| - | * to `stack.yaml` of main project add package with relative path (here `./ | + | * to `stack.yaml` of main project, add package with relative path (here `./ |
| * extract< | * extract< | ||
| . | . | ||
| Line 102: | Line 220: | ||
| * delete cabal-file (here `Test6.cabal`), | * delete cabal-file (here `Test6.cabal`), | ||
| - | * ... | + | * build the main project |
| * command:< | * command:< | ||
| stack build | stack build | ||
| Line 140: | Line 258: | ||
| </ | </ | ||
| + | |||
| + | ===== ✎ ===== | ||
| + | ~~DISCUSSION~~ | ||
toolsetup/buildingapackagelocally.1644963994.txt.gz · Last modified: (external edit)