apt-get update
apt-get install -y build-essential cmake pkg-config git curl wget \
    libzip-dev zlib1g-dev libxml2-dev libffi-dev libuv1-dev \
    libjansson-dev libczmq-dev libcurl4-openssl-dev uuid-dev libcpputest-dev

gcc --version | head -1
cmake --version | head -1
dpkg -l | grep -E "libzip-dev|libffi-dev|libuv1-dev|libcpputest" | awk '{print $2, $3}'

gcc (Ubuntu 11.4.0-1ubuntu1~22.04.3) 11.4.0
cmake version 3.22.1
libcpputest-dev:amd64 4.0-2
libffi-dev:amd64 3.4.2-4
libuv1-dev:amd64 1.43.0-1ubuntu0.1
libzip-dev:amd64 1.7.3-1ubuntu2

# 查询官方发布目录
curl -s https://downloads.apache.org/celix/ | grep -oE 'celix-[0-9.]+' | sort -V | uniq
# 查询 GitHub 最新 tag
curl -s https://api.github.com/repos/apache/celix/tags?per_page=100 | grep '"name"' | head -5
# 查看 master 分支框架版本
curl -s https://raw.githubusercontent.com/apache/celix/master/CMakeLists.txt | grep -nE "CELIX_MAJOR|CELIX_MINOR|CELIX_MICRO" | head -5

celix-2.4.0
celix-2.3.0
celix-2.2.1
celix-2.2.0
celix-2.1.0
celix-2.0.0

145:if (NOT DEFINED CELIX_MAJOR)
146:    set(CELIX_MAJOR "3")
147:    set(CELIX_MINOR "0")
148:    set(CELIX_MICRO "0")

cd /opt
git clone --depth 1 https://github.com/apache/celix.git celix-src
cd celix-src
git log -1 --format="%H %ad %s"

Cloning into 'celix-src'...
0fff190972bf1b9bb0285469f3899fab1bb82b8e Mon Sep 28 11:49:10 2026 +0800 Add tests for handling invalid JSON replies and type mismatches in JSON serializer.

cd /opt/celix-src
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/opt/celix

-- Found libzip: /usr/lib/x86_64-linux-gnu/libzip.so
-- Found jansson: /usr/lib/x86_64-linux-gnu/libjansson.so
-- Found libffi: /usr/lib/x86_64-linux-gnu/libffi.so
-- Found CURL: /usr/lib/x86_64-linux-gnu/libcurl.so (found version "7.81.0")
-- Found libuuid: /usr/lib/x86_64-linux-gnu/libuuid.so
-- Found LibXml2: /usr/lib/x86_64-linux-gnu/libxml2.so (found version "2.9.13")
-- Found RapidJSON: /usr/include/rapidjson
-- Configuring done
-- Generating done
-- Build files have been written to: /opt/celix-src/build

cd /opt/celix-src
cmake --build build -j4

[100%] Building CXX object examples/celix-examples/readme_cxx_examples/CMakeFiles/ReadmeCxxExamplesContainer.dir/__/__/__/celix/gen/containers/ReadmeCxxExamplesContainer/main.cc.o
[100%] Built target FilterExampleContainer
[100%] Linking CXX executable ../../../deploy/ReadmeCxxExamplesContainer/ReadmeCxxExamplesContainer
[100%] Built target ReadmeCxxExamplesContainer
[100%] Built target celix-containers

ls /opt/celix-src/build/libs/framework/libcelix_framework.so*
find /opt/celix-src/build -maxdepth 3 -name "celix" -type f

/opt/celix-src/build/libs/framework/libcelix_framework.so
/opt/celix-src/build/libs/framework/libcelix_framework.so.3
/opt/celix-src/build/libs/framework/libcelix_framework.so.3.0.0
/opt/celix-src/build/libs/launcher/celix

cd /opt/celix-src
cmake --install build

-- Installing: /opt/celix/share/celix/cmake/Modules/FindDNSSD.cmake
-- Installing: /opt/celix/share/celix/cmake/Modules/Findczmq.cmake
-- Installing: /opt/celix/share/celix/cmake/cmake_celix/Generic.cmake
-- Installing: /opt/celix/share/celix/cmake/cmake_celix/UseCelix.cmake
-- Installing: /opt/celix/lib/cmake/Celix/CelixConfig.cmake
-- Installing: /opt/celix/lib/cmake/Celix/CelixConfigVersion.cmake

ls /opt/celix/bin/
ls /opt/celix/lib/ | grep -E "framework|utils"

celix
libcelix_framework.so
libcelix_framework.so.2
libcelix_framework.so.2.4.0
libcelix_framework.so.3
libcelix_framework.so.3.0.0
libcelix_utils.so
libcelix_utils.so.2
libcelix_utils.so.3

/opt/celix/bin/celix -h

Usage:
  celix [-h|-p|-c] [path/to/runtime/config.properties]
Options:
        -h | --help: Show this message.
        -p | --props: Show the embedded and runtime properties for this Celix runtime and exit.
        -c | --create-bundle-cache: Create the bundle cache for this Celix runtime and exit.

cd /tmp
timeout 6 /opt/celix/bin/celix

[2026-10-13T18:03:42] [   info] [celix_framework] [framework_start:496] Celix framework started
[2026-10-13T18:03:48] [   info] [celix_framework] Stopping Celix framework due to signal Terminated

mkdir -p /opt/my-bundle/src

#include <stdio.h>
#include <celix_bundle_activator.h>

typedef struct activator_data {
    /*empty*/
} activator_data_t;

static celix_status_t activator_start(activator_data_t *data, celix_bundle_context_t *ctx) {
    printf("[my-bundle] activator_start: hello from my-bundle, bundle id=%li\n",
           celix_bundleContext_getBundleId(ctx));
    return CELIX_SUCCESS;
}

static celix_status_t activator_stop(activator_data_t *data, celix_bundle_context_t *ctx) {
    printf("[my-bundle] activator_stop: goodbye from my-bundle, bundle id=%li\n",
           celix_bundleContext_getBundleId(ctx));
    return CELIX_SUCCESS;
}

CELIX_GEN_BUNDLE_ACTIVATOR(activator_data_t, activator_start, activator_stop)

cmake_minimum_required(VERSION 3.19)
project(my_bundle C)

find_package(Celix REQUIRED)

add_celix_bundle(my_bundle
    VERSION 1.0.0
    SOURCES src/bundle.c
)

cd /opt/my-bundle
cmake -S . -B build -DCMAKE_PREFIX_PATH=/opt/celix
cmake --build build

-- Found LibXml2: /usr/lib/x86_64-linux-gnu/libxml2.so (found version "2.9.13")
-- Configuring done
-- Generating done
-- Build files have been written to: /opt/my-bundle/build
[ 25%] Building C object CMakeFiles/my_bundle.dir/src/bundle.c.o
[ 50%] Linking C shared library libmy_bundle.so
[ 75%] Generating celix/gen/bundles/my_bundle/lib-my_bundle-copy-timestamp
[100%] Packaging my_bundle
[100%] Built target my_bundle_bundle
[100%] Built target celix-bundles

unzip -l /opt/my-bundle/build/my_bundle.zip
unzip -p /opt/my-bundle/build/my_bundle.zip META-INF/MANIFEST.json

Archive:  /opt/my-bundle/build/my_bundle.zip
  Length      Date    Time    Name
---------  ---------- ----    ----
        0  2026-10-13 18:04   META-INF/
      329  2026-10-13 18:04   META-INF/MANIFEST.json
    16208  2026-10-13 18:04   libmy_bundle.so.1
---------  -------

{
    "CELIX_BUNDLE_SYMBOLIC_NAME" : "my_bundle",
    "CELIX_BUNDLE_VERSION" : "version<1.0.0>",
    "CELIX_BUNDLE_NAME" : "my_bundle",
    "CELIX_BUNDLE_ACTIVATOR_LIBRARY": "libmy_bundle.so.1",
    "CELIX_BUNDLE_PRIVATE_LIBRARIES" : ["libmy_bundle.so.1"],
    "CELIX_BUNDLE_MANIFEST_VERSION" : "version<2.0.0>"
}

cat > /opt/my-bundle/config.json <<'EOF'
{
  "CELIX_AUTO_START_0": "file:///opt/my-bundle/build/my_bundle.zip"
}
EOF
cd /opt/my-bundle
timeout 8 /opt/celix/bin/celix config.json

[my-bundle] activator_start: hello from my-bundle, bundle id=1
[2026-10-13T18:05:15] [   info] [celix_framework] [framework_start:496] Celix framework started
[2026-10-13T18:05:23] [   info] [celix_framework] Stopping Celix framework due to signal Terminated
[my-bundle] activator_stop: goodbye from my-bundle, bundle id=1

cd /opt/celix-src
cmake -L -N build | grep -E "^(BUILD_|ENABLE_|CMAKE_BUILD_TYPE|CELIX_|CMAKE_INSTALL_PREFIX)" | sort

BUILD_CELIX_DFI:BOOL=ON
BUILD_FRAMEWORK:BOOL=ON
BUILD_LAUNCHER:BOOL=ON
BUILD_SHELL:BOOL=ON
BUILD_SHELL_TUI:BOOL=ON
CELIX_ERR_BUFFER_SIZE:STRING=512
CELIX_USE_COMPRESSION_FOR_BUNDLE_ZIPS:BOOL=ON
CMAKE_BUILD_TYPE:STRING=
CMAKE_INSTALL_PREFIX:PATH=/opt/celix
ENABLE_APACHE_RAT:BOOL=OFF
ENABLE_CCACHE:BOOL=OFF
ENABLE_CODE_COVERAGE:BOOL=OFF
ENABLE_TESTING:BOOL=OFF

cd /opt
curl -sLO https://downloads.apache.org/celix/celix-2.4.0/celix-2.4.0.tar.gz
curl -sLO https://downloads.apache.org/celix/celix-2.4.0/celix-2.4.0.tar.gz.sha512
ls -la celix-2.4.0.tar.gz*

-rw-r--r-- 1 root root 2237654 Oct 13 18:19 celix-2.4.0.tar.gz
-rw-r--r-- 1 root root     204 Oct 13 18:19 celix-2.4.0.tar.gz.sha512

cd /opt
SUM=$(sha512sum celix-2.4.0.tar.gz | awk '{print $1}')
EXPECT=$(tr -d ' \n' < celix-2.4.0.tar.gz.sha512 | sed 's/celix-2.4.0.tar.gz://' | tr 'A-F' 'a-f')
echo "expected: $EXPECT"
echo "actual:   $SUM"
[ "$EXPECT" = "$SUM" ] && echo "SHA512 MATCH OK" || echo "SHA512 MISMATCH"

expected: 76fb2ba448028894841e7315f62e864a0913144a528b666106b4946a0044b45af13629a558e627de4ea6331788bae482b63601aee669e44bbc32435cc0b72ff0
actual:   76fb2ba448028894841e7315f62e864a0913144a528b666106b4946a0044b45af13629a558e627de4ea6331788bae482b63601aee669e44bbc32435cc0b72ff0
SHA512 MATCH OK

cd /opt
tar xzf celix-2.4.0.tar.gz
cd celix-2.4.0
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/opt/celix-2.4
cmake --build build -j4
cmake --install build

-- Found RapidJSON: /usr/include/rapidjson
-- Configuring done
-- Generating done
-- Build files have been written to: /opt/celix-2.4.0/build
[100%] Built target RemoteCalculatorConsumer
[100%] Built target ReadmeCxxExamplesContainer
[100%] Built target celix-containers
-- Installing: /opt/celix-2.4/lib/cmake/Celix/CelixConfig.cmake
-- Installing: /opt/celix-2.4/lib/cmake/Celix/CelixConfigVersion.cmake

/opt/celix-2.4/bin/celix -h

Usage:
  celix [-h|-p] [path/to/runtime/config.properties]
Options:
        -h | --help: Show this message.
        -p | --props: Show the embedded and runtime properties for this Celix runtime and exit.
        -c | --create-bundle-cache: Create the bundle cache for this Celix runtime and exit.
        --embedded_bundles: Show the embedded bundles for this Celix runtime and exit.

# 使用 3.0.0
/opt/celix/bin/celix -h
# 使用 2.4.0
/opt/celix-2.4/bin/celix -h

cp -r /opt/celix /opt/celix-backup-$(date +%Y%m%d)

rm -rf /opt/celix
rm -rf /opt/celix-2.4

rm -rf /opt/celix-src /opt/celix-2.4.0 /opt/my-bundle

rm -rf /tmp/.cache /root/.cache/bundle*

ls /opt/celix 2>&1; ls /opt/celix-src 2>&1

ls: cannot access '/opt/celix': No such file or directory
ls: cannot access '/opt/celix-src': No such file or directory

CMake Error at /usr/share/cmake-3.22/Modules/FindPackageHandleStandardArgs.cmake:230 (message):
  Could NOT find libuv (missing: LIBUV_LIBRARY LIBUV_INCLUDE_DIR)

apt-get install -y libuv1-dev
cd /opt/celix-src && rm -rf build && cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/opt/celix

Error creating runtime properties: Failed to open file --version.

Error creating runtime properties: Failed to parse json from <stream>:1:1: '[' or '{' expected near '#'.

cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/opt/celix -DBUILD_EXAMPLES=OFF -DBUILD_RSA_DISCOVERY_ETCD=OFF

ls /opt/celix/lib/ | grep framework

libcelix_framework.so.3
libcelix_framework.so.3.0.0