Ice

https://github.com/zeroc-ice/ice
Admin
Ice (Internet Communications Engine) is a complete RPC framework that enables building networked...
Tokens:689,888
Snippets:4,644
Trust Score:9.7
License:GPL-2.0
Update:3 days ago
Show doc for...
Tokens:
Raw
### Build the Bundle Installer

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/windows-installer/BUILDING.md

Commands to navigate to the bundle directory and build the installer in Release configuration for x64.

```cmd
cd packaging\windows-installer\bundle
dotnet build -c Release -p:Platform=x64
```

--------------------------------

### Install Ice for C++

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Install the built binaries and libraries. You can optionally specify a custom installation prefix.

```shell
make install
```

```shell
make install prefix=$HOME/ice
```

--------------------------------

### Install Build Tools

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/rpm/BUILDING.md

Install the necessary packaging tools required for building RPMs.

```bash
sudo dnf install -y \
    rpmdevtools \
    make \
    curl-minimal \
    git \
    rpm-build \
    rpm-sign
```

--------------------------------

### Start the IceBox server

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/src/iceboxnet/README.md

Use this command to start the IceBox server with a specified configuration file.

```shell
dotnet iceboxnet --Ice.Config=icebox.config
```

--------------------------------

### Complete setup with shared Slice file and public headers

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/cmake/README.md

Defines a library for a shared Slice file and a library that includes it, both with PUBLIC include scope. The shared file needs its own target; targets that link it pick up its generated headers. Both targets stage headers under one root for installation.

```cmake
# The shared Slice file needs a target of its own; targets that link it pick up its generated headers.
add_library(demo_common ../slice/Demo/Common.ice)
slice2cpp_generate(demo_common
  INCLUDE_DIRS ${CMAKE_CURRENT_SOURCE_DIR}/../slice
  HEADER_OUTPUT_DIR ${CMAKE_BINARY_DIR}/include
  INCLUDE_SCOPE PUBLIC)

add_library(weather_api Weather.ice)
slice2cpp_generate(weather_api
  INCLUDE_DIRS ${CMAKE_CURRENT_SOURCE_DIR}/../slice
  OPTIONS -DENABLE_EXTRAS
  HEADER_OUTPUT_DIR ${CMAKE_BINARY_DIR}/include
  INCLUDE_DIR Demo
  INCLUDE_SCOPE PUBLIC)
target_link_libraries(weather_api PUBLIC demo_common)
```

--------------------------------

### Using GENERATED_HEADERS with install(FILES)

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/cmake/README.md

Shows how to capture the generated headers in a variable and install them with install(FILES). This works when the generated header set is flat; for mirrored layouts, use install(DIRECTORY) instead.

```cmake
slice2cpp_generate(weather_api INCLUDE_SCOPE PUBLIC GENERATED_HEADERS weather_api_headers)
install(FILES ${weather_api_headers} DESTINATION include/Demo)
```

--------------------------------

### Install Ice JavaScript package

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Install the @zeroc/ice package using npm.

```shell
npm install @zeroc/ice
```

--------------------------------

### Install iceboxnet as a .NET tool

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/src/iceboxnet/README.md

Run this command to install the iceboxnet tool in your current project.

```shell
dotnet tool install iceboxnet --prerelease --create-manifest-if-needed
```

--------------------------------

### Generate API reference documentation

Source: https://github.com/zeroc-ice/ice/blob/main/python/BUILDING.md

Commands to set up a virtual environment, install dependencies, and build the HTML documentation.

```shell
python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate     # On Windows
```

```shell
pip install -r requirements.txt
```

```shell
make html
```

--------------------------------

### Install Build Tools

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/deb/debian/BUILDING.md

Install the necessary packaging tools required for building DEB packages.

```bash
sudo apt-get update
sudo apt-get install -y \
    locales-all \
    build-essential \
    git \
    devscripts \
    dpkg-dev \
    equivs
```

--------------------------------

### Installer Output Path

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/windows-installer/BUILDING.md

The directory where the final installer bundle is placed after a successful build.

```text
packaging\windows-installer\bundle\bin\x64\Release\
```

--------------------------------

### Server application setup

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/README.md

Initializes an Ice communicator, creates an object adapter, and registers the Chatbot implementation.

```csharp
// Server application

await using var communicator = new Ice.Communicator(ref args);

Ice.ObjectAdapter adapter =
    communicator.createObjectAdapterWithEndpoints("GreeterAdapter", "tcp -p 4061");

adapter.add(new Server.Chatbot(), new Ice.Identity { name = "greeter" });

adapter.activate();
Console.WriteLine("Listening on port 4061...");

Console.CancelKeyPress += (sender, eventArgs) =>
{
    eventArgs.Cancel = true;
    Console.WriteLine("Caught Ctrl+C, shutting down...");
    communicator.shutdown();
};

await communicator.shutdownCompleted;
```

--------------------------------

### Install Build Dependencies

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/rpm/BUILDING.md

Install the build dependencies required by the spec file.

```bash
sudo dnf builddep -y $HOME/zeroc-ice/rpmbuild/SPECS/ice.spec
```

--------------------------------

### Install Build Dependencies

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/deb/debian/BUILDING.md

Install the required build dependencies using mk-build-deps.

```bash
sudo mk-build-deps -ir -t 'apt-get -y' debian/control
```

--------------------------------

### Install Ice for C++

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Install the built Ice for C++ files to the default or a custom directory.

```shell
make -j10 install
```

```shell
make -j10 install prefix=$HOME/ice
```

--------------------------------

### Build the MSI

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/windows-installer/BUILDING.md

Commands to navigate to the MSI directory and build the installer in Release configuration for x64.

```cmd
cd packaging\windows-installer\msi
dotnet build -c Release -p:Platform=x64
```

--------------------------------

### Install third-party libraries on RHEL

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Install required third-party libraries on RHEL systems after adding the ZeroC repository.

```shell
dnf install bzip2-devel expat-devel libedit-devel libsystemd-devel lmdb-devel mcpp-devel openssl-devel
```

--------------------------------

### Prepare and Bond Bluetooth Devices

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Install the btbond APK, enable Bluetooth, and bond the client and server emulators.

```bash
BT_ADDR=$(python scripts/Controller.py --android --bt-prepare \
  --bt-client="$CLIENT" --bt-server="$SERVER" --bt-setup="$APK")
```

--------------------------------

### Install BlueZ dependencies

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Install the required Linux modules and BlueZ tools, then load the necessary kernel modules.

```bash
sudo apt-get install -y "linux-modules-extra-$(uname -r)" bluez bluez-test-tools bluez-tools
for m in bluetooth rfcomm bnep hci_vhci; do sudo modprobe "$m"; done   # l2cap is built into bluetooth.ko
```

--------------------------------

### Install nightly IceGridGUI cask with brew install --cask

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Installs the nightly IceGridGUI cask using Homebrew's cask command.

```shell
brew install --cask zeroc-ice/nightly/icegridgui@3.9
```

--------------------------------

### Install Ice for C++ on Debian and Ubuntu

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Update package lists and install the C++ development kit using APT.

```shell
sudo apt-get update
sudo apt-get install libzeroc-ice-dev
```

--------------------------------

### Create Python packages

Source: https://github.com/zeroc-ice/ice/blob/main/python/BUILDING.md

Commands to set up a virtual environment, install the build package, and generate the distribution files.

```shell
python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate     # On Windows
```

```shell
pip install build
```

```shell
python -m build
```

--------------------------------

### Start Android server controller for C++ client

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Run this command from the java directory to initialize the Android server controller.

```bash
python ../scripts/Controller.py --host-bt="A4:FF:9F:A6:48:C1" --host=192.168.1.51 --id=server --android
```

--------------------------------

### Install @zeroc/slice2js

Source: https://github.com/zeroc-ice/ice/blob/main/js/packages/slice2js/README.md

Install the package as a development dependency using npm.

```bash
npm install --save-dev @zeroc/slice2js
```

--------------------------------

### Serve API reference locally

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/BUILDING.md

Starts a local web server to view the generated API reference.

```shell
docfx serve docfx/_site
```

--------------------------------

### Start C++ server controller for Android client

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Run this command from the cpp directory to initialize the C++ server controller.

```bash
python ../scripts/Controller.py --host-bt="00:15:83:ED:D7:29" --host=192.168.1.48 --id=server
```

--------------------------------

### Install Ice for PHP on RHEL

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Install the PHP Ice package on RHEL using DNF.

```shell
sudo dnf install php-ice
```

--------------------------------

### Start secondary D-Bus daemon

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Create a custom D-Bus configuration file and start a second bluetoothd instance to prevent UUID registration conflicts.

```bash
cat > /tmp/bus2.conf <<'EOF'
<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-Bus Bus Configuration 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
  <type>system</type>
  <listen>unix:path=/tmp/bus2.sock</listen>
  <policy context="default">
    <allow user="*"/>
    <allow own="*"/>
    <allow send_type="method_call"/>
    <allow send_type="signal"/>
    <allow send_type="method_return"/>
    <allow send_type="error"/>
    <allow receive_type="*"/>
  </policy>
</busconfig>
EOF
sudo dbus-daemon --config-file=/tmp/bus2.conf --fork
sudo DBUS_SYSTEM_BUS_ADDRESS=unix:path=/tmp/bus2.sock /usr/libexec/bluetooth/bluetoothd -n &
```

--------------------------------

### Install zeroc-icegrid on Debian or Ubuntu

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Update the package list and install the zeroc-icegrid service on Debian or Ubuntu systems.

```shell
sudo apt-get update
sudo apt-get install zeroc-icegrid
```

--------------------------------

### Install nightly ice@3.9 formula with brew install

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Installs the nightly ice@3.9 formula, which includes the Ice for C++ runtime and dev kit, all Ice services (Glacier2, IceGrid, IceStorm, etc.), and all admin tools except IceGrid GUI.

```shell
brew install zeroc-ice/nightly/ice@3.9
```

--------------------------------

### Enable RHEL 9 Repositories

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/rpm/BUILDING.md

Install the Ice repository and enable the CodeReady Builder repository for RHEL 9.

```bash
sudo dnf install -y https://zeroc.com/download/ice/nightly/3.9/el9/ice-repo-3.9-nightly-1.0.0-1.el9.noarch.rpm
sudo dnf config-manager --set-enabled codeready-builder-for-rhel-9-$(arch)-rpms
```

--------------------------------

### Enable RHEL 10 Repositories

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/rpm/BUILDING.md

Install the Ice repository and enable the CodeReady Builder repository for RHEL 10.

```bash
sudo dnf install -y https://zeroc.com/download/ice/nightly/3.9/el10/ice-repo-3.9-nightly-1.0.0-1.el10.noarch.rpm
sudo dnf config-manager --set-enabled codeready-builder-for-rhel-10-$(arch)-rpms
```

--------------------------------

### Install Ice for PHP on Debian and Ubuntu

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Update package lists and install the PHP Ice package using APT.

```shell
sudo apt-get update
sudo apt-get install php-zeroc-ice
```

--------------------------------

### Install Ice for C++ on RHEL and Amazon Linux

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Install the C++ development kit using DNF after enabling the Ice nightly repository.

```shell
sudo dnf install libice-c++-devel
```

--------------------------------

### Install build dependencies on Ubuntu and Debian

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Install the necessary build tools and third-party libraries on Debian-based systems.

```shell
sudo apt-get install build-essential libbluetooth-dev libbz2-dev libdbus-1-dev libedit-dev libexpat1-dev \
  liblmdb-dev libmcpp-dev libssl-dev libsystemd-dev
```

--------------------------------

### Install build dependencies with Homebrew

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Install the required third-party libraries mcpp and lmdb using the brew package manager.

```shell
brew install mcpp lmdb
```

--------------------------------

### Execute Bluetooth Tests

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Start the controller application on the server and run the cross-platform tests on the client.

```bash
cd java
python ../scripts/Controller.py --id=server --android --controller-app \
  --device="$SERVER" --host-bt="$BT_ADDR" &
python allTests.py --server=server --protocol=bt --cross=java --android --controller-app \
  --device="$CLIENT" Ice/operations
```

--------------------------------

### Install icegrid on RHEL or Amazon Linux

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Use the dnf package manager to install the icegrid service on RHEL or Amazon Linux systems.

```shell
sudo dnf install icegrid
```

--------------------------------

### Build Ice for JavaScript

Source: https://github.com/zeroc-ice/ice/blob/main/js/BUILDING.md

Install dependencies and build the project from the js subdirectory.

```shell
npm install
npm run build
```

--------------------------------

### Install Python Ice on Debian and Ubuntu

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Use apt-get to update and install the python3-zeroc-ice package after enabling the Ice nightly repository.

```shell
sudo apt-get update
sudo apt-get install python3-zeroc-ice
```

--------------------------------

### Install Python Ice on RHEL and Amazon Linux

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Use dnf to install the python3-ice package after enabling the Ice nightly repository.

```shell
sudo dnf install python3-ice
```

--------------------------------

### Install docfx tool

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/BUILDING.md

Installs the docfx tool globally using the .NET tool manager. This is optional and required only for generating the API reference.

```shell
dotnet tool update -g docfx
```

--------------------------------

### Install ZeroC.Ice.Slice.Tools NuGet package

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/src/ZeroC.Ice.Slice.Tools/README.md

Add the package to your project to enable automatic Slice file compilation during the build process.

```sh
dotnet add package ZeroC.Ice.Slice.Tools
```

--------------------------------

### Install ZeroC repository on RHEL 9

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Add the ZeroC repository to your system for RHEL 9.

```shell
dnf install https://zeroc.com/download/ice/3.8/el9/ice-repo-3.8-1.0.0-1.el9.noarch.rpm
```

--------------------------------

### Configure Gradle for Ice Java nightly

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Example configuration for settings.gradle.kts to include the ZeroC nightly repository for plugins and dependencies.

```kotlin
// settings.gradle.kts
pluginManagement {
    repositories {
        gradlePluginPortal()
        // Use the nightly build of the Slice Tools plugin, published to the ZeroC maven-nightly repository.
        maven {
            url = uri("https://download.zeroc.com/nexus/repository/maven-3.9-nightly/")
            content {
                includeGroupByRegex("com\\.zeroc.*")
            }
        }
    }
}

dependencyResolutionManagement {
    repositories {
        mavenCentral()
        // Use the nightly build of Ice, published to the ZeroC maven-nightly repository.
        maven {
            url = uri("https://download.zeroc.com/nexus/repository/maven-3.9-nightly/")
            content {
                includeGroupByRegex("com\\.zeroc.*")
            }
        }
    }
}
```

--------------------------------

### Install ZeroC repository on RHEL 10

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Add the ZeroC repository to your system for RHEL 10.

```shell
dnf install https://zeroc.com/download/ice/3.8/el10/ice-repo-3.8-1.0.0-1.el10.noarch.rpm
```

--------------------------------

### Initialize Bluetooth Emulators

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Create and boot the emulators on a shared Netsim network with system-level permissions.

```bash
python scripts/Controller.py --android --bt-emulators \
  --bt-client="$CLIENT" --bt-server="$SERVER" --bt-image="$IMG"
```

--------------------------------

### Enable nightly repository on Ubuntu 24.04

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Download and install the repository configuration package for Ubuntu 24.04.

```shell
wget "https://download.zeroc.com/ice/nightly/3.9/ubuntu24.04/ice-repo-3.9-nightly_1.0.0_all.deb" -O ice-repo-3.9-nightly.deb
sudo dpkg -i ice-repo-3.9-nightly.deb
rm ice-repo-3.9-nightly.deb
```

--------------------------------

### Build Ice for Python with custom PythonHome

Source: https://github.com/zeroc-ice/ice/blob/main/python/BUILDING.md

Specify a custom Python installation path using the PythonHome MSBuild property.

```shell
MSBuild msbuild\ice.proj /p:PythonHome=C:\Python314
```

--------------------------------

### Client implementation in Java

Source: https://github.com/zeroc-ice/ice/blob/main/java/README.md

Demonstrates how to create a proxy and invoke the greet method on the remote Greeter interface.

```java
// Client implementation (Client.java)

import com.example.visitorcenter.GreeterPrx;
import com.zeroc.Ice.Communicator;

class Client {
    public static void main(String[] args) {
        try (var communicator = new Communicator(args)) {
            GreeterPrx greeter =
                GreeterPrx.createProxy(communicator, "greeter:tcp -h localhost -p 4061");

            String greeting = greeter.greet(System.getProperty("user.name"));
            System.out.println(greeting);
        }
    }
}
```

--------------------------------

### Run C++ client for Android server

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Execute this command from the cpp directory to run the client against the previously started Android server.

```bash
python ./allTests.py --server=server --protocol=bt --cross=java
```

--------------------------------

### Configure requirements.txt for Python Nightly

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Add these lines to your requirements.txt to use the ZeroC nightly repository for installing the zeroc-ice package.

```shell
# Use ZeroC nightly repository as the main index for pip
--index-url https://download.zeroc.com/nexus/repository/pypi-nightly/simple/

# Allow installing packages from the official PyPI index if not found in the ZeroC repository
--extra-index-url https://pypi.org/simple/

# Enable installation of pre-release versions (required for nightly builds)
--pre

# Specify the zeroc-ice package (latest nightly version)
zeroc-ice
```

--------------------------------

### Create Build Directory

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/deb/debian/BUILDING.md

Set up the workspace directory and clone the Ice repository.

```bash
mkdir -p $HOME/packaging/zeroc-ice
cd $HOME/packaging/zeroc-ice
git clone https://github.com/zeroc-ice/ice.git
mkdir build
```

--------------------------------

### Create a NuGet package for all platforms and configurations

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Set the BuildAllConfigurations property to yes to include all supported platforms and configurations in the package.

```shell
MSBuild /m msbuild\ice.proj /t:Pack /p:BuildAllConfigurations=yes
```

--------------------------------

### Run Android client for C++ server

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Execute this command from the java directory to run the client against the previously started C++ server.

```bash
python ./allTests.py --server=server --protocol=bt --cross=cpp --android
```

--------------------------------

### Client application for Greeter

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/README.md

Demonstrates how to create a proxy and invoke the GreetAsync method from a C# client.

```csharp
// Client application

using VisitorCenter;

await using var communicator = new Ice.Communicator(ref args);

GreeterPrx greeter = GreeterPrxHelper.createProxy(
    communicator,
    "greeter:tcp -h localhost -p 4061");

string greeting = await greeter.GreetAsync(Environment.UserName);
Console.WriteLine(greeting);
```

--------------------------------

### Build the plugin with Gradle

Source: https://github.com/zeroc-ice/ice/blob/main/java/tools/slice-tools/BUILDING.md

Run this command to compile the source code, execute tests, and package the plugin.

```shell
../../gradlew build
```

--------------------------------

### Create Build Directory and Clone Repository

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/rpm/BUILDING.md

Set up the workspace directory and clone the Ice source code.

```bash
mkdir -p $HOME/zeroc-ice
cd $HOME/zeroc-ice
git clone https://github.com/zeroc-ice/ice.git
```

--------------------------------

### Installing generated header root as a directory

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/cmake/README.md

Installs the entire generated header root as a tree to preserve subdirectories that generated includes rely on. Use this when the header set is mirrored, since install(FILES) cannot handle subdirectories.

```cmake
install(DIRECTORY ${CMAKE_BINARY_DIR}/include/ DESTINATION include)
```

--------------------------------

### Install Ruby Gem Nightly

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Install the latest zeroc-ice gem from the ZeroC RubyGems nightly repository.

```shell
gem install zeroc-ice --source https://download.zeroc.com/nexus/repository/rubygems-3.9-nightly --user \
    --pre --version '>= 3.9.0.pre'
```

--------------------------------

### Create virtual controllers

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Initialize two virtual Bluetooth controllers and capture their addresses for server and client roles.

```bash
sudo btvirt -B -l2 &
sudo hciconfig hci0 up && sudo hciconfig hci1 up
BT_ADDR=$(hciconfig hci1 | sed -n 's/.*BD Address: \([0-9A-F:]*\).*/\1/p')          # server
BT_CLIENT_ADDR=$(hciconfig hci0 | sed -n 's/.*BD Address: \([0-9A-F:]*\).*/\1/p')   # client
```

--------------------------------

### Install third-party libraries on Amazon Linux 2023

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Install required third-party libraries on Amazon Linux 2023.

```shell
dnf install bzip2-devel expat-devel libedit-devel systemd-devel lmdb-devel libmcpp-devel openssl-devel
```

--------------------------------

### Create the NuGet package

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/src/ZeroC.Ice.Slice.Tools/BUILDING.md

Run this command to create the ZeroC.Ice.Slice.Tools NuGet package in the project output directory.

```sh
dotnet pack /p:Platform="Any CPU" /p:Configuration=Release
```

--------------------------------

### Build Binary Packages

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/deb/debian/BUILDING.md

Build the binary packages.

```bash
dpkg-buildpackage -b -uc -us
```

--------------------------------

### Initialize RPM Build Tree

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/rpm/BUILDING.md

Create the standard directory structure for RPM building.

```bash
mkdir -p rpmbuild/{BUILD,BUILDROOT,RPMS,SOURCES,SPECS,SRPMS}
```

--------------------------------

### Install Ice for PHP on Amazon Linux

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Install the PHP 8.4 Ice package on Amazon Linux using DNF.

```shell
sudo dnf install php8.4-ice
```

--------------------------------

### Client application implementation

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/README.md

A C++ client application that initializes the Ice communicator and invokes the greet method on the Greeter proxy.

```cpp
// Client application (Client.cpp)

#include "Greeter.h"

#include <Ice/Ice.h>
#include <iostream>

using namespace std;

int main(int argc, char* argv[])
{
    Ice::CommunicatorPtr communicator = Ice::initialize(argc, argv);
    Ice::CommunicatorHolder communicatorHolder{communicator};

    VisitorCenter::GreeterPrx greeter{communicator, "greeter:tcp -h localhost -p 4061"};

    string greeting = greeter->greet("alice");
    cout << greeting << endl;
    return 0;
}
```

--------------------------------

### Build Ice for JavaScript using command arguments

Source: https://github.com/zeroc-ice/ice/blob/main/js/BUILDING.md

Pass platform and configuration arguments directly to the build command.

```shell
npm run build -- --cppPlatform=Win32 --cppConfiguration=Debug
```

--------------------------------

### Install Build Dependencies for Debian 12

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/deb/debian/BUILDING.md

Install build dependencies using the nopython profile to skip Python package building.

```bash
sudo DEB_BUILD_PROFILES="nopython" mk-build-deps -ir -t 'apt-get -y' debian/control
```

--------------------------------

### Build Ice for Java

Source: https://github.com/zeroc-ice/ice/blob/main/java/BUILDING.md

Run this command from the java subdirectory to build the project.

```shell
./gradlew build
```

--------------------------------

### Windows NuGet package installation and CMake configuration

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/cmake/README.md

On Windows, Ice for C++ is distributed as the ZeroC.Ice.Cpp NuGet package. Restore the package with nuget install, then set Ice_ROOT to the extracted directory before calling find_package. The Ice_WIN32_PLATFORM cache variable (x64 or Win32) selects the platform within the package and defaults to the build architecture.

```shell
nuget install ZeroC.Ice.Cpp -OutputDirectory packages
```

```cmake
set(Ice_ROOT "${CMAKE_CURRENT_LIST_DIR}/packages/ZeroC.Ice.Cpp.<version>")
find_package(Ice REQUIRED CONFIG)
```

--------------------------------

### Create NuGet packages

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/BUILDING.md

Creates all NuGet packages by running the Pack target on the ice.proj project.

```shell
dotnet msbuild msbuild/ice.proj /t:Pack
```

--------------------------------

### Change to MATLAB Directory

Source: https://github.com/zeroc-ice/ice/blob/main/matlab/BUILDING.md

Command to navigate to the matlab subdirectory before starting the build process.

```shell
cd matlab
```

--------------------------------

### Run tests

Source: https://github.com/zeroc-ice/ice/blob/main/BLUETOOTH.md

Execute the server and client tests using the configured virtual Bluetooth environment.

```bash
cd cpp
python3 ../scripts/Controller.py --id=server --host-bt="$BT_ADDR" &
DBUS_SYSTEM_BUS_ADDRESS=unix:path=/tmp/bus2.sock \
  python3 allTests.py --server=server --protocol=bt --cross=cpp Ice/operations
```

--------------------------------

### esbuild Plugin Configuration

Source: https://github.com/zeroc-ice/ice/blob/main/js/packages/slice2js/README.md

Configuration example for using the slice2js build plugin with esbuild.

```APIDOC
## esbuild Plugin Configuration

### Description
Configuration example for using the slice2js build plugin with esbuild.

### Method
slice2js (esbuild plugin)

### Parameters
#### options (object) - Required
- **inputs** (string | string[]) - Required - Slice files or glob patterns (e.g. "**/*.ice")
- **outputDir** (string) - Required - Output directory for generated .js and .d.ts files
- **include** (string | string[]) - Optional - Additional Slice include directories (-I flags)
- **args** (string | string[]) - Optional - Additional slice2js CLI arguments (e.g. --typescript)
- **cwd** (string) - Optional - Base directory for resolving paths (defaults to process.cwd())

### Request Example
```js
import esbuild from "esbuild";
import slice2js from "@zeroc/slice2js/unplugin/esbuild";

await esbuild.build({
    plugins: [
        slice2js({
            inputs: ["slice/*.ice"],
            outputDir: "src/generated",
            args: ["--typescript"],
        }),
    ],
});
```
```

--------------------------------

### webpack Plugin Configuration

Source: https://github.com/zeroc-ice/ice/blob/main/js/packages/slice2js/README.md

Configuration example for using the slice2js build plugin with webpack.

```APIDOC
## webpack Plugin Configuration

### Description
Configuration example for using the slice2js build plugin with webpack.

### Method
slice2js (webpack plugin)

### Parameters
#### options (object) - Required
- **inputs** (string | string[]) - Required - Slice files or glob patterns (e.g. "**/*.ice")
- **outputDir** (string) - Required - Output directory for generated .js and .d.ts files
- **include** (string | string[]) - Optional - Additional Slice include directories (-I flags)
- **args** (string | string[]) - Optional - Additional slice2js CLI arguments (e.g. --typescript)
- **cwd** (string) - Optional - Base directory for resolving paths (defaults to process.cwd())

### Request Example
```js
// webpack.config.js
import slice2js from "@zeroc/slice2js/unplugin/webpack";

export default {
    plugins: [
        slice2js({
            inputs: ["slice/*.ice"],
            outputDir: "src/generated",
            args: ["--typescript"],
        }),
    ],
};
```
```

--------------------------------

### Build the Slice Tools

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/tools/ZeroC.Ice.Slice.Tools.Cpp/BUILDING.md

Run this command in a command prompt to build the Slice Tools with the Release configuration.

```sh
dotnet build /p:Platform="Any CPU" /p:Configuration=Release
```

--------------------------------

### Rollup Plugin Configuration

Source: https://github.com/zeroc-ice/ice/blob/main/js/packages/slice2js/README.md

Configuration example for using the slice2js build plugin with Rollup.

```APIDOC
## Rollup Plugin Configuration

### Description
Configuration example for using the slice2js build plugin with Rollup.

### Method
slice2js (Rollup plugin)

### Parameters
#### options (object) - Required
- **inputs** (string | string[]) - Required - Slice files or glob patterns (e.g. "**/*.ice")
- **outputDir** (string) - Required - Output directory for generated .js and .d.ts files
- **include** (string | string[]) - Optional - Additional Slice include directories (-I flags)
- **args** (string | string[]) - Optional - Additional slice2js CLI arguments (e.g. --typescript)
- **cwd** (string) - Optional - Base directory for resolving paths (defaults to process.cwd())

### Request Example
```js
// rollup.config.js
import slice2js from "@zeroc/slice2js/unplugin/rollup";

export default {
    plugins: [
        slice2js({
            inputs: ["slice/*.ice"],
            outputDir: "src/generated",
            args: ["--typescript"],
        }),
    ],
};
```
```

--------------------------------

### Vite Plugin Configuration

Source: https://github.com/zeroc-ice/ice/blob/main/js/packages/slice2js/README.md

Configuration example for using the slice2js build plugin with Vite.

```APIDOC
## Vite Plugin Configuration

### Description
Configuration example for using the slice2js build plugin with Vite.

### Method
slice2js (Vite plugin)

### Parameters
#### options (object) - Required
- **inputs** (string | string[]) - Required - Slice files or glob patterns (e.g. "**/*.ice")
- **outputDir** (string) - Required - Output directory for generated .js and .d.ts files
- **include** (string | string[]) - Optional - Additional Slice include directories (-I flags)
- **args** (string | string[]) - Optional - Additional slice2js CLI arguments (e.g. --typescript)
- **cwd** (string) - Optional - Base directory for resolving paths (defaults to process.cwd())

### Request Example
```js
// vite.config.js
import slice2js from "@zeroc/slice2js/unplugin/vite";

export default {
    plugins: [
        slice2js({
            inputs: ["slice/*.ice"],
            outputDir: "src/generated",
            args: ["--typescript"],
        }),
    ],
};
```
```

--------------------------------

### Build Source Package

Source: https://github.com/zeroc-ice/ice/blob/main/packaging/deb/debian/BUILDING.md

Build the source package, generating .dsc and .tar.gz files.

```bash
dpkg-buildpackage -S -uc -us
```

--------------------------------

### Slice Greeter Interface

Source: https://github.com/zeroc-ice/ice/blob/main/doxygen/mainpage.md

An example Slice definition for a simple Greeter interface with a greet operation.

```APIDOC
## Slice Greeter Interface

### Description
This is an example Slice definition for a simple Greeter interface. It defines a greet operation that creates a personalized greeting.

### Interface
module VisitorCenter
{
    /// Represents a simple greeter.
    interface Greeter
    {
        /// Creates a personalized greeting.
        /// @param name The name of the person to greet.
        /// @return The greeting.
        string greet(string name);
    }
}

### Operation
- **greet** (string name) -> string

### Parameters
- **name** (string) - Required - The name of the person to greet.

### Return Value
- **string** - The greeting.
```

--------------------------------

### Server implementation in Java

Source: https://github.com/zeroc-ice/ice/blob/main/java/README.md

Sets up an object adapter and registers the Chatbot implementation to listen for incoming requests on port 4061.

```java
// Server implementation (Server.java)

import com.zeroc.Ice.Communicator;
import com.zeroc.Ice.Identity;
import com.zeroc.Ice.ObjectAdapter;

class Server {
    public static void main(String[] args) {
        try (var communicator = new Communicator(args)) {
            ObjectAdapter adapter =
                communicator.createObjectAdapterWithEndpoints("GreeterAdapter", "tcp -p 4061");
            adapter.add(new Chatbot(), new Identity("greeter", ""));

            adapter.activate();
            System.out.println("Listening on port 4061...");

            communicator.waitForShutdown();
        }
    }
}
```

--------------------------------

### Client application main.py

Source: https://github.com/zeroc-ice/ice/blob/main/python/README.md

A client application that connects to the Greeter service and invokes the greetAsync method.

```python
# Client application (main.py)
import Ice
import asyncio
import getpass
import sys

import VisitorCenter


async def main():
    async with Ice.Communicator(sys.argv, eventLoop=asyncio.get_running_loop()) as communicator:
        greeter = VisitorCenter.GreeterPrx(communicator, "greeter:tcp -h localhost -p 4061")
        greeting = await greeter.greetAsync(getpass.getuser())
        print(greeting)


if __name__ == "__main__":
    asyncio.run(main())
```

--------------------------------

### Create the ZeroC.Ice.Cpp NuGet package

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Use the Pack target to create the NuGet package for the current platform and configuration.

```shell
MSBuild /m msbuild\ice.proj /t:Pack
```

--------------------------------

### Enable nightly repository on Debian 13

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Download and install the repository configuration package for Debian 13.

```shell
wget "https://download.zeroc.com/ice/nightly/3.9/debian13/ice-repo-3.9-nightly_1.0.0_all.deb" -O ice-repo-3.9-nightly.deb
sudo dpkg -i ice-repo-3.9-nightly.deb
rm ice-repo-3.9-nightly.deb
```

--------------------------------

### Enable nightly repository on Debian 12

Source: https://github.com/zeroc-ice/ice/blob/main/NIGHTLY.md

Download and install the repository configuration package for Debian 12.

```shell
wget "https://download.zeroc.com/ice/nightly/3.9/debian12/ice-repo-3.9-nightly_1.0.0_all.deb" -O ice-repo-3.9-nightly.deb
sudo dpkg -i ice-repo-3.9-nightly.deb
rm ice-repo-3.9-nightly.deb
```

--------------------------------

### Implement Greeter server application

Source: https://github.com/zeroc-ice/ice/blob/main/swift/README.md

A server application that initializes the communicator, creates an object adapter, and activates the servant.

```swift
// Server application

import Ice

let ctrlCHandler = CtrlCHandler()

var args = CommandLine.arguments
let communicator = try Ice.initialize(&args)

defer {
    communicator.destroy()
}

let adapter = try communicator.createObjectAdapterWithEndpoints(
    name: "GreeterAdapter", endpoints: "tcp -p 4061")

try adapter.add(servant: Chatbot(), id: Ice.Identity(name: "greeter"))

try adapter.activate()
print("Listening on port 4061...")

ctrlCHandler.setCallback { signal in
    print("Caught signal \(signal), shutting down...")
    communicator.shutdown()
}

await communicator.shutdownCompleted()

```

--------------------------------

### Create @zeroc/ice NPM package

Source: https://github.com/zeroc-ice/ice/blob/main/js/BUILDING.md

Pack the ice package for distribution.

```shell
cd packages/ice
npm pack
```

--------------------------------

### Implement Greeter client application

Source: https://github.com/zeroc-ice/ice/blob/main/swift/README.md

A client application that initializes the Ice communicator, creates a proxy, and calls the greet method.

```swift
// Client application

import Foundation
import Ice

var args = CommandLine.arguments
let communicator = try Ice.initialize(&args)

defer {
    communicator.destroy()
}

let greeter = try makeProxy(
    communicator: communicator, proxyString: "greeter:tcp -h localhost -p 4061",
    type: GreeterPrx.self)

let greeting = try await greeter.greet(NSUserName())

print(greeting)

```

--------------------------------

### Configure and Initialize IceDiscovery

Source: https://github.com/zeroc-ice/ice/blob/main/csharp/src/IceDiscovery/README.md

Configures the Ice communicator to load the IceDiscovery plug-in during initialization, which installs a default locator.

```csharp
// Configure the communicator to load the IceDiscovery plug-in during initialization.
// This plug-in installs a default locator on the communicator.
var initData = new Ice.InitializationData
{
    properties = new Ice.Properties(ref args),
    pluginFactories = [new IceDiscovery.PluginFactory()]
};

// Create an Ice communicator.
await using var communicator = new Ice.Communicator(initData);
```

--------------------------------

### PHP client application for Greeter

Source: https://github.com/zeroc-ice/ice/blob/main/php/README.md

A PHP client implementation that initializes the Ice communicator and invokes the greet method on a remote proxy.

```php
<?php
// Client application (Client.php)

require_once 'Ice.php';
require_once 'Greeter.php';

$communicator = Ice\initialize();
$greeter = VisitorCenter\GreeterPrxHelper::createProxy($communicator, 'greeter:tcp -h hello.zeroc.com -p 4061');

$greeting = $greeter->greet(get_current_user());
echo "$greeting\n";
?>
```

--------------------------------

### Run iOS tests via controller

Source: https://github.com/zeroc-ice/ice/blob/main/cpp/BUILDING.md

Start the iOS tests after deploying the controller app to a device or simulator.

```shell
python allTests.py --all --platform iphoneos
```

```shell
python allTests.py --all --platform iphonesimulator
```
Tokens:
Raw