GitHub releases APIを用いたXR Animatorの自動更新

GitHub Releasesにある最新のリリース情報は固定のURLから取得できる。これを使って自動更新やUI上から更新をサポートしていないXR Animatorの自動更新をサポートする。

#最新のリリース情報の取得

GitHub Releasesでは、次のAPIから最新のリリース情報を取得できる。

1
https://api.github.com/repos/${OWNER}/${REPO}/releases/latest

XR Animatorの場合は、次のURLになる。

https://api.github.com/repos/ButzYung/SystemAnimatorOnline/releases/latest

レスポンスは次のような形式になっており、browser_download_urlからダウンロードURLを取得できる。

1
{
2
   // ...重要な箇所以外は省略
3
  "tag_name": "XR-Animator_v0.33.0",
4
  "published_at": "2025-11-16T16:11:13Z",
5
  "assets": [
6
        {
7
            // ...
8
            "name": "XR-Animator_v0.33.0_linux-x64.zip",
9
            "browser_download_url": "https://github.com/...."
10
        },
11
        {
12
            // ...
13
            "name": "XR-Animator_v0.33.0_macos-arm64.zip",
14
        }

#アセットのダウンロード

GitHub Releases APIで取得したデータから目的のアセットのダウンロードURLを取得する。

例えば、XR Animatorの最新のWindows版アセットのダウンロードURLは次のように取得できる。

1
curl -s https://api.github.com/repos/ButzYung/SystemAnimatorOnline/releases/latest | \
2
   jq -r '.assets[] | select(.name | contains("windows")) | .browser_download_url '

このコマンドでは、jqコマンドでassets配列の中からnameにwindowsを含むアセットのbrowser_download_urlを取得している。目的のアセットに合わせて、jqのクエリを変更する。

取得されたURLに対してダウンロードを行えば、目的のアセットが手に入る。

1
curl -sSO https://github.com/ButzYung/SystemAnimatorOnline/releases/download/XR-Animator_v0.33.0/XR-Animator_v0.33.0_windows.zip

ダウンロードされるファイル名を変更したい場合は、-Oの代わりに小文字の-oオプションを使い-o <filename>とする。-sSは標準出力を抑制しつつエラーは表示するおまじないなので無くてもいい。

#XR Animatorの自動更新

ここまでのリリース情報の取得方法とXR Animatorの仕様を組み合わせると、次のようなシェルスクリプトで自動更新ができる。

このスクリプトでは実行時に毎回リリースを確認し、更新があれば自動的にインストールを行う。

1
#!/bin/bash
2

3
set -euo pipefail
4

5
# Constants
6
readonly BASE_DIR="${XR_ANIMATOR_DIR:-./XR-Animator}"
7
readonly API_URL="https://api.github.com/repos/ButzYung/SystemAnimatorOnline/releases/latest"
8
readonly VERSION_FILE="${BASE_DIR}/.version"
9
readonly CONFIG_FILE_NAME="XR Animator.js"
10

11
# Global variables
12
PLATFORM=""
13
RELEASE_JSON=""
14
LATEST_TAG=""
15
LATEST_VERSION=""
16

17
# Cleanup on error
18
cleanup() {
19
    local exit_code=$?
20
    if [ -n "${TEMP_DIR:-}" ] && [ -d "${TEMP_DIR:-}" ]; then
21
        rm -rf "${TEMP_DIR}" 2>/dev/null || true
22
    fi
23
    if [ -n "${ZIP_FILE:-}" ] && [ -f "${ZIP_FILE:-}" ]; then
24
        rm -f "${ZIP_FILE}" 2>/dev/null || true
25
    fi
26
    exit "${exit_code}"
27
}
28
trap cleanup EXIT INT TERM
29

30
# Detect platform
31
detect_platform() {
32
    case "$(uname -s)" in
33
        MINGW*|MSYS*|CYGWIN*)
34
            PLATFORM="windows"
35
            ;;
36
        Linux*)
37
            PLATFORM="linux"
38
            ;;
39
        Darwin*)
40
            PLATFORM="macOS"
41
            ;;
42
        *)
43
            echo "Error: Unsupported OS" >&2
44
            exit 1
45
            ;;
46
    esac
47
}
48

49
# Extract version number from tag name
50
extract_version_from_tag() {
51
    local tag="$1"
52
    echo "${tag}" | sed -n 's/.*v\([0-9.]*\)/\1/p' | sed 's/^/v/'
53
}
54

55
# Fetch latest release information
56
fetch_latest_release() {
57
    if [ -z "${RELEASE_JSON:-}" ]; then
58
        RELEASE_JSON=$(curl -sf "${API_URL}" || {
59
            echo "Error: Failed to fetch release information from GitHub API" >&2
60
            exit 1
61
        })
62
        LATEST_TAG=$(echo "${RELEASE_JSON}" | jq -r '.tag_name // empty')
63
        if [ -z "${LATEST_TAG}" ]; then
64
            echo "Error: Failed to get release tag" >&2
65
            exit 1
66
        fi
67
        LATEST_VERSION=$(extract_version_from_tag "${LATEST_TAG}")
68
    fi
69
}
70

71
# Get current version
72
get_current_version() {
73
    if [ -f "${VERSION_FILE}" ]; then
74
        cat "${VERSION_FILE}" | tr -d '[:space:]'
75
    fi
76
}
77

78
# Check if existing installation exists
79
check_existing_installation() {
80
    find "${BASE_DIR}" -maxdepth 1 -type d -name "XR Animator - electron-*" 2>/dev/null | head -n 1
81
}
82

83
# Check if update is needed
84
check_update_needed() {
85
    local current_version
86
    current_version=$(get_current_version)
87

88
    local electron_dir
89
    electron_dir=$(check_existing_installation)
90

91
    if [ -z "${current_version}" ]; then
92
        # .version file does not exist
93
        fetch_latest_release
94

95
        if [ -n "${electron_dir}" ]; then
96
            # Existing installation found, assume it matches latest version
97
            echo "${LATEST_VERSION}" > "${VERSION_FILE}"
98
            return 1  # No update needed
99
        else
100
            return 0  # Update needed
101
        fi
102
    else
103
        # Current version exists, compare with latest tag
104
        fetch_latest_release
105

106
        if [ "${current_version}" != "${LATEST_VERSION}" ]; then
107
            return 0  # Update needed
108
        else
109
            return 1  # No update needed
110
        fi
111
    fi
112
}
113

114
# Get download URL
115
get_download_url() {
116
    fetch_latest_release
117
    echo "${RELEASE_JSON}" | jq -r ".assets[] | select(.name | contains(\"${PLATFORM}\")) | .browser_download_url" | head -n 1
118
}
119

120
# Copy config file
121
copy_config_file() {
122
    local old_gadget="$1"
123
    local new_gadget="$2"
124

125
    if [ -z "${old_gadget}" ] || [ -z "${new_gadget}" ] || [ "${old_gadget}" = "${new_gadget}" ]; then
126
        return 0
127
    fi
128

129
    local old_config="${old_gadget}/TEMP/_config_local/${CONFIG_FILE_NAME}"
130
    local new_config="${new_gadget}/TEMP/_config_local/${CONFIG_FILE_NAME}"
131

132
    if [ -f "${old_config}" ] && [ ! -f "${new_config}" ]; then
133
        mkdir -p "$(dirname "${new_config}")"
134
        cp "${old_config}" "${new_config}"
135
    fi
136
}
137

138
# Perform update
139
perform_update() {
140
    local download_url="$1"
141

142
    if [ -z "${download_url}" ]; then
143
        echo "Error: Failed to get download URL" >&2
144
        exit 1
145
    fi
146

147
    fetch_latest_release
148

149
    # Temporary directory and ZIP file paths
150
    ZIP_FILE="${BASE_DIR}/update.zip"
151
    TEMP_DIR="${BASE_DIR}/.update_temp"
152

153
    # Download
154
    echo "Downloading latest version..."
155
    curl -sfSL -o "${ZIP_FILE}" "${download_url}" || {
156
        echo "Error: Download failed" >&2
157
        exit 1
158
    }
159

160
    # Extract to temporary directory
161
    rm -rf "${TEMP_DIR}"
162
    mkdir -p "${TEMP_DIR}"
163
    unzip -q "${ZIP_FILE}" -d "${TEMP_DIR}" || {
164
        echo "Error: Failed to extract ZIP file" >&2
165
        exit 1
166
    }
167
    rm -f "${ZIP_FILE}"
168

169
    # Backup config file (before update)
170
    local old_gadget
171
    old_gadget=$(find "${BASE_DIR}" -maxdepth 1 -type d -name "AT_SystemAnimator_*" 2>/dev/null | sort | head -n 1)
172

173
    # Remove old directories
174
    echo "Removing old files..."
175
    find "${BASE_DIR}" -maxdepth 1 -type d -name "XR Animator - electron-*" -exec rm -rf {} \; 2>/dev/null || true
176
    find "${BASE_DIR}" -maxdepth 1 -type d -name "AT_SystemAnimator_*" -exec rm -rf {} \; 2>/dev/null || true
177
    find "${BASE_DIR}" -maxdepth 1 -type d -name "accessories" -exec rm -rf {} \; 2>/dev/null || true
178

179
    # Move new files
180
    echo "Installing new files..."
181
    find "${TEMP_DIR}" -maxdepth 1 -type d -name "XR Animator - electron-*" -exec mv {} "${BASE_DIR}/" \; 2>/dev/null || true
182
    find "${TEMP_DIR}" -maxdepth 1 -type d -name "AT_SystemAnimator_*" -exec mv {} "${BASE_DIR}/" \; 2>/dev/null || true
183

184
    if [ -d "${TEMP_DIR}/accessories" ]; then
185
        [ -d "${BASE_DIR}/accessories" ] && rm -rf "${BASE_DIR}/accessories"
186
        mv "${TEMP_DIR}/accessories" "${BASE_DIR}/"
187
    fi
188

189
    if [ -f "${TEMP_DIR}/readme.txt" ]; then
190
        mv "${TEMP_DIR}/readme.txt" "${BASE_DIR}/" 2>/dev/null || true
191
    fi
192

193
    # Remove temporary directory
194
    rm -rf "${TEMP_DIR}"
195

196
    # Copy config file (after update)
197
    local new_gadget
198
    new_gadget=$(find "${BASE_DIR}" -maxdepth 1 -type d -name "AT_SystemAnimator_*" 2>/dev/null | sort | tail -n 1)
199
    if [ -n "${old_gadget}" ] && [ -n "${new_gadget}" ]; then
200
        copy_config_file "${old_gadget}" "${new_gadget}"
201
    fi
202

203
    # Update .version file
204
    echo "${LATEST_VERSION}" > "${VERSION_FILE}"
205
    echo "Update completed: ${LATEST_VERSION}"
206
}
207

208
# Find Electron executable
209
find_electron_executable() {
210
    local electron_dir="$1"
211
    local exe_path="${electron_dir}/electron.exe"
212

213
    if [ ! -f "${exe_path}" ]; then
214
        exe_path=$(find "${electron_dir}" -maxdepth 1 -type f \( -name "electron" -o -name "electron.exe" \) 2>/dev/null | head -n 1)
215
    fi
216

217
    if [ -z "${exe_path}" ] || [ ! -f "${exe_path}" ]; then
218
        echo "Error: Electron executable not found" >&2
219
        exit 1
220
    fi
221

222
    echo "${exe_path}"
223
}
224

225
# Main function
226
main() {
227
    # Check required commands
228
    for cmd in curl jq unzip find; do
229
        if ! command -v "${cmd}" >/dev/null 2>&1; then
230
            echo "Error: Command '${cmd}' not found" >&2
231
            exit 1
232
        fi
233
    done
234

235
    detect_platform
236

237
    # Check for updates
238
    if check_update_needed; then
239
        local download_url
240
        download_url=$(get_download_url)
241

242
        if [ -z "${download_url}" ]; then
243
            echo "Error: Download URL for ${PLATFORM} not found" >&2
244
            exit 1
245
        fi
246

247
        perform_update "${download_url}"
248
    else
249
        echo "No update needed"
250
    fi
251

252
    # Launch Electron
253
    local electron_dir
254
    electron_dir=$(find "${BASE_DIR}" -maxdepth 1 -type d -name "XR Animator - electron-*" 2>/dev/null | sort | tail -n 1)
255

256
    if [ -z "${electron_dir}" ]; then
257
        echo "Error: Electron directory not found" >&2
258
        exit 1
259
    fi
260

261
    local electron_exe
262
    electron_exe=$(find_electron_executable "${electron_dir}")
263

264
    exec "${electron_exe}" "$@"
265
}
266

267
main "$@"