Conda-build Documentation¶

Building a conda package requires installing conda build and creating a conda recipe. Use the conda build command to build the conda package from the conda recipe.

You can build conda packages from a variety of source code projects, most notably Python. For help packing a Python project, see the Setuptools documentation.

OPTIONAL: If you are planning to upload your packages to Anaconda Cloud, you will need an Anaconda Cloud account and client.

Installing and updating conda build
- Installing conda build
- Updating conda and conda build
Conda packages walkthrough and building Anaconda installers
- Anatomy of a package
- Channels and generating an index
- Installing with conda
  - Conda install
  - Specifying channels
- Building Anaconda installers
Overview
- What is a “package”?
- What about channels
- Building Anaconda installers
Conda package specification
- Package metadata
- Link and unlink scripts
- Repository structure and index
- Package match specifications
  - Examples
Package naming conventions
- package name
- package version
- build string
- canonical name
- filename
- package specification
Conda build recipes
- Conda build process
Conda channels
- Identical channel and package name problem
Defining metadata (meta.yaml)
- Package section
  - Package name
  - Package version
- Source section
- Build section
- Requirements section
  - Build
  - Host
  - Run
- Test section
- Outputs section
- About section
  - License file
- App section
- Extra section
- Templating with Jinja
  - Conda-build specific Jinja2 functions
- Preprocessing selectors
Build scripts (build.sh, bld.bat)
Features
Environment variables
- Dynamic behavior based on state of build process
- Environment variables set during the build process
- Git environment variables
- Mercurial environment variables
- Inherited environment variables
- Environment variables that affect the build process
- Environment variables to set build features
- Environment variables that affect the test process
Making packages relocatable
Adding pre-link, post-link and pre-unlink scripts
Build Variants
- General pinning examples
- Transition guide
- Creating conda-build variant config files
- Using variants with the conda-build API
- About reproducibility
- Special variant keys
- Coupling keys
- Avoiding unnecessary builds
- CONDA_* variables and command line arguments to conda-build
- Aggregation of multiple variants
- Bootstrapping pins based on an existing environment
- Extended keys
- Customizing compatibility
  - Pinning expressions
  - Pinning at the variant level
  - Pinning at the recipe level
- Appending to recipes
- Partially clobbering recipes
- Differentiating packages built with different variants
- Extra Jinja2 functions
- Referencing subpackages
- Compiler packages
- Compiler versions
- Cross-compiling
- Self-consistent package ecosystems
Using shared libraries
- Shared libraries in Windows
- Shared libraries in macOS and Linux
Anaconda compiler tools
- Compiler packages
- Using the compiler packages
- macOS SDK
- Backward compatibility
- Anaconda compilers and conda-build 3
- An aside on cmake and sysroots
- Customizing the compilers
- Using your customized compiler package with conda-build 3
Adding Windows Start menu items
Sample recipes
Building a package without a recipe (bdist_conda)
- Setup options
- Command line options
  - Build number
- Notes
Using wheel files with conda
- Building a conda package from a wheel file
Conda-build CLI reference
- conda build
- conda convert
- conda develop
- conda index
- conda inspect
- conda inspect channels
- conda inspect linkages
- conda inspect objects
- conda metapackage
- conda render
- conda skeleton
- conda skeleton cpan
- conda skeleton cran
- conda skeleton luarocks