wtandClaude Opus 5.5
29a4664401
Wide banner with the watch, project name and stack tags, shown at the top of README. Also list branding/ in the structure trees of README and AGENTS.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
<p align="center">
|
||
<img src="branding/banner.png" alt="BalanceWatch — учёт личных финансов на Apple Watch" width="100%">
|
||
</p>
|
||
|
||
# BalanceWatch
|
||
|
||
Самостоятельное (watch-only) приложение Balance для watchOS 10+, выделенное
|
||
из монорепозитория Balance (`Balance/BalanceWatch` + общий код).
|
||
|
||
Стек: SwiftUI + SwiftData, синхронизация через self-hosted BalanceServer.
|
||
|
||
## Структура
|
||
|
||
```text
|
||
BalanceWatch/
|
||
├── branding/ # аватар и баннер для README (PNG + SVG-исходники)
|
||
├── BalanceWatch.xcodeproj/
|
||
└── BalanceWatch/
|
||
├── App/ # точка входа и экраны часов
|
||
├── Models/ # SwiftData-модели (копия из монорепы)
|
||
├── Shared/ # контейнер SwiftData, тема, ServerSync
|
||
├── Utilities/ # FinanceCalculations, форматирование валют
|
||
├── Views/Components/ # CategoryIconView
|
||
└── Assets.xcassets # иконка приложения
|
||
```
|
||
|
||
Проект использует папки, синхронизируемые с файловой системой (Xcode 16+):
|
||
любой `.swift`-файл, положенный в `BalanceWatch/`, автоматически попадает в
|
||
таргет — править `project.pbxproj` вручную не нужно.
|
||
|
||
## Сборка
|
||
|
||
1. Открыть `BalanceWatch.xcodeproj` в Xcode 16 или новее.
|
||
2. Выбрать схему `BalanceWatch` и симулятор Apple Watch.
|
||
3. В Signing & Capabilities при необходимости поменять Team и
|
||
bundle id (`com.tolamironcenko.Balance.watchkitapp`).
|
||
|
||
Из командной строки:
|
||
|
||
```bash
|
||
xcodebuild -project BalanceWatch.xcodeproj -scheme BalanceWatch \
|
||
-destination 'generic/platform=watchOS Simulator' build
|
||
```
|
||
|
||
## CI
|
||
|
||
GitHub Actions (`.github/workflows/build.yml`) собирает проект на
|
||
`macos-15` с последним стабильным Xcode для двух назначений — watchOS
|
||
Simulator и watchOS device (без подписи). Запускается на push в
|
||
`main`/`develop`, на pull request и вручную (Run workflow). При падении
|
||
лог `xcodebuild` прикладывается к запуску как артефакт.
|
||
|
||
## Важно
|
||
|
||
Модели, `FinanceCalculations.swift` и `ServerSync.swift` — копии общего
|
||
кода из монорепозитория. Протокол синхронизации и правила расчётов должны
|
||
совпадать с остальными клиентами Balance: при изменении контракта на
|
||
сервере переносите правки и сюда.
|