Быстрые стартеры
Как построить бекенд для WatchOS?

41min
Введение
В этом учебном пособии вы узнаете как создать бэкенд для watchOS приложений с использованием Back4App. 
Создаете ли вы расширение WatchKit для вашего приложения для iPhone или разрабатываете отдельный опыт Apple Watch, Back4App упрощает вашу работу, предоставляя необходимые инструменты. 
Вы интегрируете такие функции, как безопасная база данных, функции Cloud Code, запросы в реальном времени (Live Queries) и аутентификация пользователей — все это без управления собственными серверами.
Вы также увидите, как быстрая процедура запуска Back4App и удобная среда позволяют вам сосредоточиться на функциональности ваших приложений watchOS, а не на настройке серверов. 
В процессе вы научитесь выполнять такие задачи, как планирование заданий, настройка вебхуков и конфигурация push-уведомлений. 
К концу у вас будет прочная основа для расширения ваших приложений для часов или приложений для iOS для производственных нужд, при этом обеспечивая бесшовную синхронизацию данных (по интернет-соединению) между приложением WatchKit и вашим бэкендом.
Предварительные требования
Учетная запись Back4App и новый проект Back4App
 Начало работы с Back4app.
Если у вас нет учетной записи, вы можете создать ее бесплатно. Следуйте приведенному выше руководству, чтобы подготовить ваш проект.
Среда разработки watchOS/Xcode
 У вас должна быть установлена Xcode с SDK watchOS. Вы можете запускать и собирать ваше расширение WatchKit как на реальных Apple Watch, так и в симуляторе.
Parse Swift SDK
Используйте Swift Package Manager для установки и настройки SDK для ваших watchOS или комбинированных iOS приложений.
Знание Swift, Xcode и экосистемы разработки Apple
 Документация для разработчиков Apple.
Если вы новичок на платформах Apple, потратьте некоторое время на изучение документации по watchOS и iOS перед началом.
Убедитесь, что вы соответствуете этим предварительным требованиям, прежде чем начать. Наличие настроенного проекта Back4App и готовой локальной среды watchOS поможет вам легко следовать инструкциям.
Шаг 1 – Создание нового проекта на Back4App и подключение
Почему вам нужен проект Back4App
Новый проект Back4App необходим для хранения всех данных и выполнения облачного кода для ваших watchOS приложений. Это служит основой вашего бэкенда.
Создайте ваш проект
Войдите в Back4App.
Нажмите “Новое приложение” в панели управления.
Назовите ваше приложение (например, “WatchOS-Backend-Tutorial”).
﻿
Установите Parse Swift SDK
Добавьте зависимость Parse Swift в ваш Package.swift или используя Файл → Swift Packages → Добавить зависимость пакета в Xcode. Укажите URL:
Swift
dependencies: [
    .package(url: "https://github.com/netreconlab/Parse-Swift.git", from: "5.0.0")
]
dependencies: [
    .package(url: "https://github.com/netreconlab/Parse-Swift.git", from: "5.0.0")
]
﻿
Инициализируйте Parse в вашем watchOS или общем коде
В коде запуска вашего приложения WatchKit или в общем файле, доступном как для вашего watchOS так и для iPhone приложения, инициализируйте Parse:
Swift
@main
struct MyWatchApp: App {
    init() {
        Task {
            do {
                try await ParseSwift.initialize(
                    applicationId: "YOUR_APP_ID",
                    clientKey: "YOUR_CLIENT_KEY",
                    serverURL: URL(string: "https://parseapi.back4app.com")!
                )
            } catch {
                print("Error initializing Parse: \(error)")
            }
        }
    }
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
@main
struct MyWatchApp: App {
    init() {
        Task {
            do {
                try await ParseSwift.initialize(
                    applicationId: "YOUR_APP_ID",
                    clientKey: "YOUR_CLIENT_KEY",
                    serverURL: URL(string: "https://parseapi.back4app.com")!
                )
            } catch {
                print("Error initializing Parse: \(error)")
            }
        }
    }
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
﻿
На этом этапе ваше watchOS приложение может взаимодействовать с бэкендом Back4App. Будь то независимое Apple Watch приложение или расширение WatchKit в паре с iPhone приложением, все данные бэкенда проходят через Parse Swift SDK.
Шаг 2 – Настройка базы данных
1. Создание модели данных
Back4App использует функцию схемы на запись Parse Server. Вы можете определить таблицы (классы) в разделе Back4App Database или позволить им создаваться автоматически, когда объекты впервые сохраняются. Например, если ваши watch приложения отслеживают данные о здоровье, у вас может быть класс “HealthMetrics” с полями, такими как частота сердечных сокращений, шаги или тип тренировки.
2. Создание модели данных с использованием AI Agent
AI Agent от Back4App AI Agent позволяет вам описывать вашу схему на простом языке:
Откройте AI Agent в панели управления вашего приложения.
Укажите детали, такие как “Пожалуйста, создайте класс Watch Metrics с полями: dailySteps (Число), heartRate (Число).”
AI автоматически создаст схему для вас.
﻿
3. Чтение и запись данных с использованием SDK
Ниже приведен пример сохранения и запроса данных из приложения watchOS. Предположим, у нас есть HealthMetrics структура:
Swift
import ParseSwift

struct HealthMetrics: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var dailySteps: Int?
    var heartRate: Int?
}

// Saving data
func saveMetrics(steps: Int, heart: Int) async {
    var metrics = HealthMetrics()
    metrics.dailySteps = steps
    metrics.heartRate = heart

    do {
        let saved = try await metrics.save()
        print("Saved metrics: \(saved)")
    } catch {
        print("Error saving: \(error)")
    }
}

// Querying data
func fetchLatestMetrics() async {
    let query = HealthMetrics.query()
    do {
        let results = try await query.find()
        print("Fetched: \(results.count) items")
    } catch {
        print("Error fetching: \(error)")
    }
}
import ParseSwift

struct HealthMetrics: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var dailySteps: Int?
    var heartRate: Int?
}

// Saving data
func saveMetrics(steps: Int, heart: Int) async {
    var metrics = HealthMetrics()
    metrics.dailySteps = steps
    metrics.heartRate = heart

    do {
        let saved = try await metrics.save()
        print("Saved metrics: \(saved)")
    } catch {
        print("Error saving: \(error)")
    }
}

// Querying data
func fetchLatestMetrics() async {
    let query = HealthMetrics.query()
    do {
        let results = try await query.find()
        print("Fetched: \(results.count) items")
    } catch {
        print("Error fetching: \(error)")
    }
}
﻿
4. Чтение и запись данных с использованием REST API
При необходимости ваши watchOS или iOS приложения также могут отправлять REST-запросы:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dailySteps": 8000, "heartRate": 75}' \
  https://parseapi.back4app.com/classes/HealthMetrics
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dailySteps": 8000, "heartRate": 75}' \
  https://parseapi.back4app.com/classes/HealthMetrics
﻿
5. Чтение и запись данных с использованием GraphQL
Back4App также предоставляет конечную точку GraphQL. Например:
GraphQL
mutation {
  createHealthMetrics(input: {
    fields: {
      dailySteps: 7500
      heartRate: 70
    }
  }) {
    healthMetrics {
      objectId
      dailySteps
      heartRate
    }
  }
}
mutation {
  createHealthMetrics(input: {
    fields: {
      dailySteps: 7500
      heartRate: 70
    }
  }) {
    healthMetrics {
      objectId
      dailySteps
      heartRate
    }
  }
}
﻿
6. Работа с живыми запросами (по желанию)
Если вам нужны обновления данных в реальном времени на вашем Apple Watch, включите живые запросы:
Включите Live Queries в разделе Server Settings в Back4App.
Настройте URL живого запроса в вашем коде watchOS:
Swift
ParseLiveQuery.configure(url: URL(string: "wss://YOUR_SUBDOMAIN.b4a.io")!)
ParseLiveQuery.configure(url: URL(string: "wss://YOUR_SUBDOMAIN.b4a.io")!)
﻿
Затем подпишитесь на изменения:
Swift
func subscribeMetricsUpdates() async throws {
    let subscription = HealthMetrics.query().subscribe()
    for try await event in subscription {
        switch event {
        case .created(let newData):
            print("New data: \(newData)")
        case .updated(let updatedData):
            print("Updated: \(updatedData)")
        default:
            break
        }
    }
}
func subscribeMetricsUpdates() async throws {
    let subscription = HealthMetrics.query().subscribe()
    for try await event in subscription {
        switch event {
        case .created(let newData):
            print("New data: \(newData)")
        case .updated(let updatedData):
            print("Updated: \(updatedData)")
        default:
            break
        }
    }
}
﻿
Шаг 3 – Применение безопасности с помощью ACL и CLP
1. Краткий обзор
Back4App позволяет использовать списки контроля доступа (ACL) и разрешения на уровне классов (CLP) для защиты вашей базы данных. Например, вы можете ограничить доступ к определенным метрикам только для пользователя, который их создал, или разрешить доступ только для аутентифицированных аккаунтов.
2. Пошаговая настройка
Разрешения на уровне классов
Перейдите в База данных → Класс → Безопасность для определения значений по умолчанию (например, только для чтения для всех, запись для владельцев).
ACL в коде
Вы можете добавить ACL к каждому объекту в вашем WatchKit или общем коде. Например:
Swift
if let user = User.current {
    var acl = ParseACL()
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)

    var metrics = HealthMetrics()
    metrics.ACL = acl
}
if let user = User.current {
    var acl = ParseACL()
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)

    var metrics = HealthMetrics()
    metrics.ACL = acl
}
﻿
Это гарантирует, что только вошедший в систему пользователь может просматривать или изменять объекты HealthMetrics, которые они создают.
Шаг 4 – Написание функций облачного кода
1. Зачем нужен облачный код
Облачный код помогает вам выполнять сложные или конфиденциальные операции на стороне сервера, такие как валидация данных, вызовы внешних API или ведение журналов. Эта настройка полезна для минимизации нагрузки на устройства watchOS и сохранения заряда батареи на Apple Watch.
2. Пример функции
В вашем main.js:
JS
Parse.Cloud.define('processMetrics', async (request) => {
  const { dailySteps, heartRate } = request.params;
  if (!dailySteps || !heartRate) {
    throw 'Missing parameters.';
  }
  // Example: Simple calculation
  return dailySteps * heartRate;
});
Parse.Cloud.define('processMetrics', async (request) => {
  const { dailySteps, heartRate } = request.params;
  if (!dailySteps || !heartRate) {
    throw 'Missing parameters.';
  }
  // Example: Simple calculation
  return dailySteps * heartRate;
});
﻿
3. Развертывание
Используйте Back4App CLI для развертывания:
Bash
b4a deploy
b4a deploy
﻿
Bash
b4a deploy
b4a deploy
﻿
Bash
b4a deploy
b4a deploy
﻿
4. Установка модулей NPM
Если вам нужны внешние библиотеки в вашем Cloud Code:
Добавьте зависимости в package.json (в папке вашего Cloud Code).
Используйте require('your-lib') в main.js.
Шаг 5 – Настройка аутентификации
1. Включите аутентификацию пользователей
По умолчанию класс User готов в Back4App. Убедитесь, что «Включить разрешения на уровне класса» настроено правильно для объектов пользователей.
2. Примеры кода
В Parse Swift вы можете зарегистрировать пользователя из вашего кода watchOS:
Swift
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String : [String : String]?]?
}

func signUpNewUser(name: String, pass: String, mail: String) async {
    var newUser = User()
    newUser.username = name
    newUser.password = pass
    newUser.email = mail

    do {
        let signedUp = try await newUser.signUp()
        print("Sign Up successful: \(signedUp)")
    } catch {
        print("Error signing up: \(error)")
    }
}
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String : [String : String]?]?
}

func signUpNewUser(name: String, pass: String, mail: String) async {
    var newUser = User()
    newUser.username = name
    newUser.password = pass
    newUser.email = mail

    do {
        let signedUp = try await newUser.signUp()
        print("Sign Up successful: \(signedUp)")
    } catch {
        print("Error signing up: \(error)")
    }
}
﻿
3. Социальный вход
Если вы планируете интегрировать вход через Apple, Google или Facebook в ваше приложение watchOS или iPhone, вы можете сделать это с помощью соответствующих функций социального входа Parse Swift. См. Документация Back4App для получения подробной информации.
Шаг 6 – Обработка хранения файлов
1. Настройка хранения файлов
Если ваши приложения для часов нуждаются в загрузке изображений, журналов или небольших файлов данных, вы можете полагаться на ParseFile:
Swift
func uploadFile(data: Data, fileName: String) async {
    let file = ParseFile(name: fileName, data: data)
    do {
        let savedFile = try await file.save()
        print("Uploaded file: \(savedFile.url ?? "")")
    } catch {
        print("Error uploading file: \(error)")
    }
}
func uploadFile(data: Data, fileName: String) async {
    let file = ParseFile(name: fileName, data: data)
    do {
        let savedFile = try await file.save()
        print("Uploaded file: \(savedFile.url ?? "")")
    } catch {
        print("Error uploading file: \(error)")
    }
}
﻿
2. Пример
Вы можете хранить изображения тренировок или ежедневные снимки прогресса:
Swift
let snapshotData = // ...some image data from watch screenshot
Task {
    await uploadFile(data: snapshotData, fileName: "workout.jpg")
}
let snapshotData = // ...some image data from watch screenshot
Task {
    await uploadFile(data: snapshotData, fileName: "workout.jpg")
}
﻿
3. Соображения безопасности
Проверьте ваши ACL файлов. По умолчанию URL-адреса файлов доступны, если кто-то получит прямую ссылку. Вы можете защитить или контролировать доступ к файлам через конфигурацию файлов вашего сервера parse.
Шаг 7 – Подтверждение электронной почты и сброс пароля
1. Обзор
Пользователи Apple Watch могут не всегда управлять входами непосредственно на часах, но включение подтверждения электронной почты помогает сохранить их данные в безопасности.
2. Конфигурация панели управления Back4App
Перейдите в Настройки приложения → Электронная почта.
Включите Подтверждение электронной почты.
Настройте шаблоны по мере необходимости.
3. Код/Реализация
Для сброса пароля:
Swift
do {
    try await User.requestPasswordReset(email: "[email protected]")
} catch {
    print("Error requesting password reset: \(error)")
}
do {
    try await User.requestPasswordReset(email: "example@domain.com")
} catch {
    print("Error requesting password reset: \(error)")
}
﻿
Swift
do {
    try await User.requestPasswordReset(email: "[email protected]")
} catch {
    print("Error requesting password reset: \(error)")
}
do {
    try await User.requestPasswordReset(email: "example@domain.com")
} catch {
    print("Error requesting password reset: \(error)")
}
﻿
Шаг 8 – Планирование задач с помощью облачных заданий
1. Что делают облачные задания
Облачные задания позволяют автоматизировать фоновые задачи, такие как ротация старых данных или генерация отчетов о использовании для вашей аналитики watchOS.
2. Пример
В main.js:
JS
Parse.Cloud.job('cleanUpMetrics', async (request) => {
  const query = new Parse.Query('HealthMetrics');
  // For example, remove records older than 7 days
  const now = new Date();
  const cutoff = new Date(now - 7 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', cutoff);

  const oldMetrics = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldMetrics, { useMasterKey: true });
  return `Deleted ${oldMetrics.length} old records.`;
});
Parse.Cloud.job('cleanUpMetrics', async (request) => {
  const query = new Parse.Query('HealthMetrics');
  // For example, remove records older than 7 days
  const now = new Date();
  const cutoff = new Date(now - 7 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', cutoff);

  const oldMetrics = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldMetrics, { useMasterKey: true });
  return `Deleted ${oldMetrics.length} old records.`;
});
﻿
Разверните ваш код.
Перейдите в Настройки приложения → Настройки сервера → Фоновые задания и запланируйте его на ежедневной основе.
Планирование облачного задания
﻿
Шаг 9 – Интеграция вебхуков
1. Определение
Вебхуки уведомляют внешние сервисы, когда в вашем приложении происходят определенные события. Например, вы можете захотеть отправлять уведомление в канал Slack каждый раз, когда записывается новая метрика.
2. Конфигурация
В панели управления Back4App перейдите в Дополнительно → Вебхуки.
Добавьте вебхук с конечной точкой (например, URL Slack).
Выберите событие (например, “Новая запись в HealthMetrics”).
Добавление вебхука
﻿
3. Пример
Каждый раз, когда пользователь добавляет новую запись dailySteps, ваш канал Slack получает уведомление. Вы также можете определить более сложную логику в Cloud Code для отправки пользовательских данных в ваши внешние сервисы.
Шаг 10 – Изучение панели администратора Back4App
1. Где это найти
Панель администратора доступна через вашу консоль Back4App в разделе Дополнительно → Админ-приложение.
Включите его и создайте администратора для управления данными через веб-интерфейс, если вам нужен простой интерфейс для не технических заинтересованных сторон.
Включить админ-приложение
﻿
2. Функции
Просмотр и редактирование данных
Управление журналами и облачными заданиями
Отслеживание аналитики или отправка уведомлений
Это простой способ сотрудничать с данными без необходимости прямого доступа к базе данных или коду.
Заключение
На протяжении этого руководства вы узнали как создать бэкенд для watchOS с использованием мощных функций Back4App. Вы настроили безопасную схему базы данных, написали облачный код, обрабатывали запросы в реальном времени и реализовали аутентификацию пользователей. Теперь ваше приложение WatchKit может хранить и синхронизировать данные с минимальными усилиями.
Следующие шаги
Усовершенствуйте свои приложения для часов путем интеграции продвинутых облачных функций для персонализированных уведомлений или преобразования данных.
Изучите дополнительные функции приложений iOS, такие как фоновая синхронизация и стратегии кэширования для вашего Apple Watch.
Читать официальную документацию Back4App для получения дополнительной информации о продвинутой безопасности, аналитике и производительности.
Оптимизируйте для App Store для распространения вашего расширения watchOS или отдельного приложения для часов.
Расширяя свой бэкенд, вы можете предоставить надежные приложения для watchOS которые работают без сбоев даже при ограниченном интернет-соединении. Продолжайте развивать и наслаждайтесь мощью Back4App для ваших опытов с Apple Watch!
Обновлено 23 Jan 2025
Помогла ли вам эта страница?
Как построить бэкенд для jQuery?
Как построить бэкэнд для tvOS?