Docker 컨테이너에서 Linux ARM32 및 Aarch64 바코드 QR 스캐너를 빌드하는 방법

Raspberry Pi, Arduino, Jetson Nano 등과 같은 임베디드 및 IoT 장치용 바코드 QR 코드 스캐너 응용 프로그램을 빌드하고 테스트하려는 경우 물리적 장치는 개발에 반드시 필요한 것은 아닙니다. 이 문서에서는 Dynamsoft Barcode SDK을 사용하여 Docker 컨테이너에서 Linux ARM32 및 Aarch64(ARM64라고도 함)용 바코드 QR 코드 판독 응용 프로그램을 빌드하는 방법을 보여줍니다. 샘플 코드는 C++ 및 Python으로 작성되었습니다.

Linux ARM32 및 Aarch64 실행을 위한 Docker 이미지

Linux ARM32 및 Aarch64용 Docker 이미지가 많이 있으므로 처음부터 빌드할 필요가 없습니다. arm32v7/gcc 및 arm64v8/gcc은 완전한 GCC 환경을 제공했습니다. 기본 이미지로 사용할 수 있습니다.

docker pull arm32v7/gcc
docker pull arm64v8/gcc

multiarch/qemu-user-static은 x86_64 Linux에서 ARM32 및 Aarch64 명령어를 에뮬레이션하는 데 필요합니다.

docker run --rm --privileged multiarch/qemu-user-static:register --reset

Linux ARM32 및 Aarch64용 C++ 바코드 QR 코드 스캐너

Windows (x86_64) , macOS(x86_64) 및 Linux(x86_64, ARM32, and ARM64) 를 지원하는 Dynamsoft Barcode SDK로 개발된 C++ sample code을 다운로드하십시오.

git clone https://github.com/yushulx/cmake-cpp-barcode-qrcode.git

프로젝트 폴더를 컨테이너에 복사하지 않고 Docker 컨테이너에 마운트합니다. 나중에 배포할 때 편리합니다.

docker run --platform linux/arm/v7 -it --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v7/gcc 

docker run --platform linux/arm64/v8 -it --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm64v8/gcc 

그런 다음 cmake를 설치하고 프로젝트를 빌드합니다.

apt install -y cmake
mkdir build 
cmake -B build 
cmake --build build --config release 
cmake --install build

실행 파일과 공유 라이브러리는 dist 명령을 실행한 후 --install 폴더에 복사됩니다. 다음을 통해 애플리케이션을 실행할 수 있습니다.

./dist/BarcodeReader ./images/AllSupportedBarcodeTypes.png ./license-key.txt

30-day trial license key을 가져와 license-key.txt 파일에 저장합니다.

Linux ARM32 및 Aarch64용 Python 바코드 QR 코드 스캐너

Python barcode QR code sample의 소스 코드를 가져옵니다.

git clone https://github.com/yushulx/python-barcode-qrcode-sdk.git

GCC Docker 이미지에는 pip 없이 Python 환경이 포함되어 있습니다.

먼저 pip를 설치한 다음 Docker 컨테이너 내부에 휠 파일을 빌드하는 데 필요한 다른 Python 패키지를 설치합니다.

apt install python3-pip -y
pip3 install auditwheel patchelf-wrapper

Python 휠 파일을 빌드하고 auditwheel 로 복구합니다. manylinux에서 지원하는 휠 파일만 PyPI에 업로드할 수 있습니다.

python3 setup_setuptools.py bdist_wheel
auditwheel repair wheelhouse/{*.whl} --plat manylinux2014_$(uname -m)

다음과 같이 Python 바코드 QR 코드 스캐너 SDK를 설치하고 테스트할 수 있습니다.

pip3 install wheelhouse/{*.whl}
python3 test.py

Linux ARM32 및 Aarch64 바코드 QR 코드 스캐너 빌드를 위한 GitHub 작업

GitHub Actions는 소프트웨어 빌드 및 릴리스를 자동화하는 도구입니다. Linux ARM32 및 Aarch64 바코드 QR 코드 스캐너 애플리케이션을 구축, 테스트 및 배포하기 위한 작업 워크플로우를 구성할 수 있습니다.

CMake 프로젝트 빌드를 위한 GitHub 작업

우리는 두 가지 작업을 생성합니다. 하나는 arm32용이고 다른 하나는 arm64용입니다. 기본 단계는 다음과 같습니다.

GitHub 저장소에서 프로젝트를 복제합니다.

QEMU 사용자 정적 이미지를 설정합니다.

Docker 컨테이너를 실행하여 프로젝트를 빌드하고 테스트합니다.

zip 도구를 사용하여 dist 폴더를 압축합니다.

패키지를 아티팩트 파일로 다운로드할 수 있도록 합니다.

name: CMake

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

env:
  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
  BUILD_TYPE: Release

jobs:
  arm32_build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3  

    - name: Set up QEMU
      uses: docker/setup-qemu-action@v2

    - name: CMake build and run
      run: |
        docker run --platform linux/arm/v7 --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v7/gcc bash -c "apt update && apt install -y cmake; mkdir build && cmake -B build && cmake --build build --config ${{env.BUILD_TYPE}} && cmake --install build; ./dist/BarcodeReader ./images/AllSupportedBarcodeTypes.png ./license-key.txt"

    - name: Archive Release
      uses: thedoctor0/zip-release@main
      with:
        type: 'zip'
        filename: arm32.zip
        exclusions: '*.git* /*node_modules/* .editorconfig'
        path: ${{github.workspace}}/dist

    - uses: actions/upload-artifact@v2
      with:
        path: ./*.zip

  arm64_build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3  

    - name: Set up QEMU
      uses: docker/setup-qemu-action@v2

    - name: CMake build and run
      run: |
        docker run --platform linux/arm64/v8 --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm64v8/gcc bash -c "apt update && apt install -y cmake; mkdir build && cmake -B build && cmake --build build --config ${{env.BUILD_TYPE}} && cmake --install build; ./dist/BarcodeReader ./images/AllSupportedBarcodeTypes.png ./license-key.txt"

    - name: Archive Release
      uses: thedoctor0/zip-release@main
      with:
        type: 'zip'
        filename: arm64.zip
        exclusions: '*.git* /*node_modules/* .editorconfig'
        path: ${{github.workspace}}/dist

    - uses: actions/upload-artifact@v2
      with:
        path: ./*.zip

Python 휠 빌드를 위한 GitHub 작업

cibuildwheel은 Python 휠 파일을 빌드하는 공식 도구입니다. 그것은 manylinux2014 aarch64 Docker 이미지를 지원합니다.

여기서는 cibuildwheel을 사용하여 aarch64 휠 파일만 빌드합니다.

GitHub 저장소에서 프로젝트를 복제합니다.

Python 환경을 설정합니다.

QEMU 사용자 정적 이미지를 설정합니다.

Docker 컨테이너에서 cibuildwheel을 사용하여 Python 휠 파일을 빌드합니다.

Python 바코드 QR 코드 스캐너 SDK를 테스트합니다.

모든 Python 휠 파일을 아티팩트로 패키징합니다.

모든 Python 휠 파일을 PyPI에 업로드합니다.

name: Build and upload to PyPI

on: [push, pull_request]

jobs:
  build_wheels:
    name: Build wheels on ${{ matrix.os }}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-20.04]

    steps:
      - uses: actions/checkout@v2

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.x'

      - name: Set up QEMU
        if: runner.os == 'Linux'
        uses: docker/setup-qemu-action@v2
        with:
          platforms: all

      - name: Build wheels
        uses: pypa/[email protected]
        env:
          CIBW_ARCHS_LINUX: aarch64 

      - name: Run test.py in develop mode
        run: |
          python setup_setuptools.py develop
          python -m pip install opencv-python
          python --version
          python test.py
      - uses: actions/upload-artifact@v2
        with:
          path: ./wheelhouse/*.whl

  build_sdist:
    name: Build source distribution
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - name: Build sdist
        run: pipx run build --sdist

      - uses: actions/upload-artifact@v2
        with:
          path: dist/*.tar.gz

  upload_pypi:
    needs: [build_wheels, build_sdist]
    runs-on: ubuntu-latest
    # upload to PyPI on every tag starting with 'v'
    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
    # alternatively, to publish when a GitHub Release is created, use the following rule:
    # if: github.event_name == 'release' && github.event.action == 'published'
    steps:
      - uses: actions/download-artifact@v2
        with:
          name: artifact
          path: dist

      - uses: pypa/[email protected]
        with:
          user: __token__
          password: ${{ secrets.pypi_password }}
          skip_existing: true