4.6 KiB

Raw Permalink Blame History

Build Guide

Build Dependencies

Before building Linglong, ensure the following dependencies are installed:

cmake
debhelper-compat (= 12)
intltool
libcli11-dev (>= 2.4.1) | hello
libcurl4-openssl-dev
libdeflate-dev
libelf-dev
libexpected-dev (>= 1.0.0~dfsg-2~bpo10+1) | hello
libfuse3-dev
libglib2.0-dev
libgmock-dev
libgtest-dev
liblz4-dev
liblzma-dev
libostree-dev
libpcre2-dev
libselinux1-dev
libssl-dev
libsystemd-dev
libyaml-cpp-dev (>= 0.6.2)
libzstd-dev
nlohmann-json3-dev (>= 3.5.0)
pkg-config
qt6-base-dev | qtbase5-dev
qt6-base-private-dev | qtbase5-private-dev
systemd
zlib1g-dev

Linglong uses cmake presets. To build and install:

cmake --workflow --preset release
sudo cmake --install build-release

For development/debugging:

export CMAKE_CXX_COMPILER_LAUNCHER="$(command -v ccache)"

# Configure, build and test
cmake --workflow --preset debug

# Configure only
cmake --preset debug

# Build only
cmake --build --preset debug

# Test only
ctest --preset debug

Packaging

Linglong uses CPM.cmake to download missing dependencies locally.

To disable this feature:

export CPM_USE_LOCAL_PACKAGES=1

See CPM.cmake README for more information.

Internationalization (i18n) Management

Linglong uses GNU gettext toolchain and Transifex platform for internationalization.

Translation Workflow

graph TD
    A[Mark Source Code] --> B[Generate POT Template]
    B --> C[Create/Update PO Files]
    C --> D[Translate PO Files]
    D --> E[Compile MO Files]
    E --> F[Runtime Usage]
    C --> G[Upload to Transifex]
    G --> H[Translator Collaboration]
    H --> C

1. Environment Setup

1.1 Install Transifex CLI

wget https://github.com/transifex/cli/releases/download/v1.6.17/tx-linux-amd64.tar.gz
tar -xzf tx-linux-amd64.tar.gz -C $HOME/.local/bin/
tx -v  # Verify version

1.2 Configure Transifex

Create ~/.transifexrc:

[https://www.transifex.com]
rest_hostname = https://rest.api.transifex.com
api_hostname = https://api.transifex.com
hostname = https://www.transifex.com
token = <your-transifex-token>

Configure project .tx/config:

[main]
host = https://www.transifex.com

[o:linuxdeepin:p:linyaps:r:6e861fdc8edf8f03ac6f0b629a022f2f]
file_filter = po/<lang>.po
source_file = po/en_US.po
source_lang = en_US
type = PO

2. Translation File Management

2.1 Generate POT Template

# In build directory
make pot  # Generates po/linyaps.pot

2.2 Update PO Files

make po              # Update all PO files
make linyaps_zh_CN.po  # Update specific language

2.3 Translation Collaboration

Push translation files to git repository:

git add po/linyaps.pot po/en_US.po
git push $(REMOTE) $(BRANCH)

Upload translation files to Transifex:

tx push -a # Push all languages
tx push --translation -f --languages zh_CN # Push specific language

TIPS: Typically we only push translations for the current system language, while translators will collaborate on other languages in Transifex.

Download translations:

tx pull -a  # All languages
tx pull -l zh_CN  # Specific language

3. Compilation & Testing

Compile PO to MO:

msgfmt po/zh_CN.po -o share/locale/zh_CN/LC_MESSAGES/linyaps.mo

Test translations:

LANG=zh_CN.UTF-8 ll-cli --help

Best Practices

String Marking:

// Use gettext macros
#include <libintl.h>
#define _(str) gettext(str)

printf(_("Hello World"));

Translation Context:

/// TRANSLATORS: System username, max 20 chars
printf(_("User"));

// Plural forms
printf(ngettext("%d file", "%d files", count), count);

Quality Checks:

# Check untranslated strings
msgfmt --statistics po/zh_CN.po

# Validate format
msgfmt -cv po/zh_CN.po

Collaboration Standards:
- Preserve source context
- Avoid variable placeholders (e.g. %s)
- Maintain terminology consistency
- Use full-width punctuation for Chinese
Regular Sync:
- Weekly POT updates to Transifex
- Monthly full translation pulls
- Pre-release testing:

for lang in $(cat po/LINGUAS); do
  LANG=$lang.UTF-8 ll-cli --help > /dev/null || echo "$lang test failed"
done

Common Issues:
- Outdated translations: Use msgmerge
- Format errors: Check quotes/special chars
- Variable order: Use positional params (%1$s)
- Length constraints: Chinese is typically shorter

4.6 KiB Raw Permalink Blame History