Updated

Author: yushulx

examples/official/ip_camera/gui_client/IPCameraViewer.spec

@@ -0,0 +1,68 @@
+# -*- mode: python ; coding: utf-8 -*-
+from PyInstaller.utils.hooks import collect_all
+
+# Collect all DLLs, .pyd extensions, data files (models/templates/resources),
+# and hidden imports for dynamsoft_capture_vision_bundle so they are bundled
+# into the executable and available at runtime via sys._MEIPASS.
+dcvb_datas, dcvb_binaries, dcvb_hiddenimports = collect_all('dynamsoft_capture_vision_bundle')
+
+a = Analysis(
+    ['main.py'],
+    pathex=[],
+    binaries=dcvb_binaries,
+    datas=dcvb_datas,  # config.json is NOT embedded — distribute it next to the exe so users can edit the license key
+    hiddenimports=dcvb_hiddenimports + [
+        # Dynamsoft sub-modules loaded dynamically at runtime
+        'dynamsoft_capture_vision_bundle',
+        'dynamsoft_capture_vision_bundle.core',
+        'dynamsoft_capture_vision_bundle.cvr',
+        'dynamsoft_capture_vision_bundle.dbr',
+        'dynamsoft_capture_vision_bundle.dcp',
+        'dynamsoft_capture_vision_bundle.dcpd',
+        'dynamsoft_capture_vision_bundle.ddn',
+        'dynamsoft_capture_vision_bundle.dip',
+        'dynamsoft_capture_vision_bundle.dlr',
+        'dynamsoft_capture_vision_bundle.id_utility',
+        'dynamsoft_capture_vision_bundle.license',
+        'dynamsoft_capture_vision_bundle.utility',
+        # Other runtime dependencies
+        'cv2',
+        'numpy',
+        'requests',
+        'PySide6',
+        'PySide6.QtCore',
+        'PySide6.QtGui',
+        'PySide6.QtWidgets',
+        'PySide6.QtNetwork',
+    ],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+pyz = PYZ(a.pure)
+
+# One-file executable: all binaries and datas are embedded in the EXE.
+# On first run the files are extracted to a temporary directory (sys._MEIPASS).
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='IPCameraViewer',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)

examples/official/ip_camera/gui_client/README.md

@@ -0,0 +1,80 @@
+# IP Camera Viewer
+
+A desktop application for viewing IP camera streams with real-time barcode/QR code scanning, built with PySide6 and the Dynamsoft Capture Vision SDK.
+
+## Requirements
+
+- Python 3.9 – 3.12
+- Windows x64 (the Dynamsoft native DLLs bundled in this project target `win_amd64`)
+
+## Run from source
+
+```bash
+pip install -r requirements.txt
+python main.py
+```
+
+## Build a standalone executable with PyInstaller
+
+The provided `IPCameraViewer.spec` packages everything—including all Dynamsoft DLLs, model files, and template JSON files—into a **single self-contained `.exe`** that can be copied to any Windows PC without requiring Python or any additional packages.
+
+### 1. Install dependencies (one-time)
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Build the executable
+
+Run this command from the `gui_client` directory:
+
+```bash
+pyinstaller IPCameraViewer.spec
+```
+
+The finished executable is written to:
+
+```
+dist/IPCameraViewer.exe
+```
+
+### 3. Distribute
+
+Copy **both files** to the same folder on the target machine:
+
+```
+IPCameraViewer.exe
+config.json
+```
+
+`config.json` is intentionally **not** embedded in the exe so the license key and other settings can be edited with any text editor without rebuilding.
+
+> **Note:** On first launch the application unpacks its embedded files to a temporary folder (`%TEMP%\_MEIxxxxxx`). This is normal PyInstaller behaviour for one-file executables and takes a few seconds.
+
+---
+
+### What the spec does
+
+| Problem | Fix applied in `IPCameraViewer.spec` |
+|---|---|
+| Dynamsoft DLLs (`Dynamsoft*x64.dll`) not found at runtime | `collect_all('dynamsoft_capture_vision_bundle')` adds all DLLs as `binaries` |
+| Dynamsoft model/template/resource `.data` and `.json` files missing | Same `collect_all` call adds them as `datas` under `dynamsoft_capture_vision_bundle/` |
+| Sub-modules imported by name at runtime not detected by PyInstaller | Full list added to `hiddenimports` |
+| One-folder output inconvenient for distribution | Switched to **one-file** mode (`a.binaries` + `a.datas` embedded directly in `EXE`) |
+| `config.json` (contains license key) inaccessible when embedded in exe | Excluded from `datas`; resolved at runtime from `sys.executable`'s directory so users can edit it freely |
+
+### Regenerating the spec from scratch
+
+If you need to rebuild the spec (e.g., after a major dependency change), use:
+
+```bash
+pyinstaller --onefile --noconsole --name IPCameraViewer \
+    --collect-all dynamsoft_capture_vision_bundle \
+    --hidden-import cv2 \
+    --hidden-import numpy \
+    --hidden-import requests \
+    --add-data "config.json;." \
+    main.py
+```
+
+> On Windows use `;` as the path separator in `--add-data`. On Linux/macOS use `:`.

examples/official/ip_camera/gui_client/barcode_scanner.py

@@ -133,7 +133,8 @@ def _load_license_from_config(self):
         import json
 
         try:
-            config_path = os.path.join(os.path.dirname(__file__), 'config.json')
+            _cfg_dir = os.path.dirname(sys.executable) if getattr(sys, 'frozen', False) else os.path.dirname(os.path.abspath(__file__))
+            config_path = os.path.join(_cfg_dir, 'config.json')
             if os.path.exists(config_path):
                 with open(config_path, 'r') as f:
                     config = json.load(f)

examples/official/ip_camera/gui_client/main.py

@@ -506,7 +506,8 @@ def show_about_dialog(self):
     def load_app_settings(self) -> Dict[str, Any]:
         """Load application settings"""
         try:
-            config_file = os.path.join(os.path.dirname(__file__), 'config.json')
+            _cfg_dir = os.path.dirname(sys.executable) if getattr(sys, 'frozen', False) else os.path.dirname(os.path.abspath(__file__))
+            config_file = os.path.join(_cfg_dir, 'config.json')
             if os.path.exists(config_file):
                 with open(config_file, 'r') as f:
                     return json.load(f)
@@ -530,7 +531,8 @@ def load_app_settings(self) -> Dict[str, Any]:
     def save_app_settings(self):
         """Save application settings"""
         try:
-            config_file = os.path.join(os.path.dirname(__file__), 'config.json')
+            _cfg_dir = os.path.dirname(sys.executable) if getattr(sys, 'frozen', False) else os.path.dirname(os.path.abspath(__file__))
+            config_file = os.path.join(_cfg_dir, 'config.json')
             with open(config_file, 'w') as f:
                 json.dump(self.app_settings, f, indent=2)
         except Exception as e: