{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"28731736077"}},"macroMetadata":{"macroId":{"value":"a7849e58-bdaa-4ef0-8665-16ac97499ca6"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d2c06d9d-af15-4e12-a083-6312478e439b"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The following tutorials are targeting the currently known most simple and clean way of building any Python packages, even if those include platform specific extension (mostly C/C++) code.","type":"text"}]},{"type":"paragraph","content":[{"text":"These steps assume clean (Win10) system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Third party dependencies should be solved case by case and as soon as those are solved, these can be the final steps to create release packages.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"1. Setting the evironment","type":"text"}]},{"type":"paragraph","content":[{"text":"Common requirement","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install Visual Studio 2019","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ARM64 build tools ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.2. Build machine: x64","type":"text"}]},{"type":"paragraph","content":[{"text":"Background: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://linaro.atlassian.net/wiki/spaces/WOAR/pages/28593914166/setuptools-distutils#4.-WoA-(win-arm64)-support"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"1. Install latest (matching with the arm64win Python version in next step) win-x64 Python release to x64 machine from","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.python.org/downloads/windows/"}}]}]}]},{"type":"paragraph","content":[{"text":"2. Get latest (same version as x64 above) arm64win Python from ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://nuget.org"}},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1360,"id":"ad5c63a6-3fa6-4ea6-95cd-9a294d3db151","collection":"contentId-28731736077","type":"file","height":659}}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.10 release:","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.nuget.org/packages/pythonarm64/3.10.0"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"rename it to .zip","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"unzip","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"3. Create and activate virtual environment by the x64 Python","type":"text"}]},{"type":"codeBlock","content":[{"text":"C:\\Users\\\\AppData\\Local\\Programs\\Python\\Python310-32\\python.exe --version\nPython 3.10.0rc1\nC:\\Users\\\\AppData\\Local\\Programs\\Python\\Python310-32\\python.exe -m venv \n\\Scripts\\activate.bat","type":"text"}]},{"type":"paragraph","content":[{"text":"4. Copy arm64win Python libs to x64 venv","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"copy","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"from","type":"text"}]},{"type":"codeBlock","content":[{"text":"\\libs","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"to ","type":"text"}]},{"type":"codeBlock","content":[{"text":"\\libs","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"5.Make sure latest distutils is used from setuptools (not older than ","type":"text"},{"text":"setuptools-57.4.0","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update setuptools within venv","type":"text"}]},{"type":"codeBlock","content":[{"text":"(venv_3.10_rc1) python -m pip install -U setuptools","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"set environment variableto use distutils from this module and not the global Python’s internal one","type":"text"}]},{"type":"codeBlock","content":[{"text":"set SETUPTOOLS_USE_DISTUTILS=local","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"6. Set environment variables to mimic cross-compilation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"codeBlock","content":[{"text":"set VSCMD_ARG_TGT_ARCH=arm64\nset SETUPTOOLS_EXT_SUFFIX=.cp310-win_arm64.pyd","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"7. Goto ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://linaro.atlassian.net/wiki/spaces/WOAR/pages/28594241585/Package+building+tutorial#2.-Build-the-package"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.2. Build machine: WoA = win-arm64","type":"text"}]},{"type":"paragraph","content":[{"text":"Background: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://linaro.atlassian.net/wiki/spaces/WOAR/pages/28593914166/setuptools-distutils#4.-WoA-(win-arm64)-support"}},{"text":" ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Get release version of arm64python","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Current latest prerelease build: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.nuget.org/packages/pythonarm64/3.10.0-rc2"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename it to zip","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unzip and use python.exe from that path","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create and activate virtual environment","type":"text"}]},{"type":"codeBlock","content":[{"text":"\\python.exe -m venv \n\\Scripts\\activate.bat","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install pre-release arm64win packages","type":"text"},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://linaro.atlassian.net/wiki/spaces/WOAR/pages/28598239406/Python#Custom-pre-release-package-builds-(wheel-files)"}},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pip","type":"text"}]},{"type":"codeBlock","content":[{"text":" python -m pip install \n python -m pip install --force-reinstall","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"note: the 2nd force-reinstall is required to generate the arm64win pip executables with the updated distlib of the 1st installation","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"setuptools","type":"text"}]},{"type":"codeBlock","content":[{"text":" pip install ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Goto ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://linaro.atlassian.net/wiki/spaces/WOAR/pages/28594241585/Package+building+tutorial#2.-Build-the-package"}},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"2. Build the package","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.1. Test the system","type":"text"}]},{"type":"paragraph","content":[{"text":"The final goal here is to have a portable wheel file, but until we’re not sure the extension (mostly C/C++) build process (build_ext) is working, for try and error it doesn’t make sense to invoke the full process of wheel generation.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the current project has any specific build steps, then use those.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Otherwise","type":"text"}]},{"type":"codeBlock","content":[{"text":" python setup.py build_ext","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.2. Create portable wheel file","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"note: this step requires to install wheel by pip","type":"text"}]},{"type":"codeBlock","content":[{"text":" pip install wheel","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If project specific build process or generic build_ext is working, we can try wheel generation","type":"text"}]},{"type":"codeBlock","content":[{"text":" pip wheel --no-cache-dir --no-build-isolation -w ","type":"text"}]}]}]}],"version":1}

Browser not supported