Чтение JSON файла в Swift: пошаговое руководство для iOS 8 и новее

Правильный способ чтения JSON из файла в Swift

Ваша проблема типична для начинающих разработчиков. Давайте разберём её по шагам. Основные ошибки: неправильная настройка Xcode, устаревший API для iOS 8 и некорректная обработка ошибок.

1. Убедитесь, что файл добавлен в Bundle

В Xcode выберите файл users.json в навигаторе. В правой панели (File Inspector) проверьте, что в секции Target Membership стоит галочка напротив вашего приложения. Если нет — поставьте. Без этого файл не попадёт в финальный .app bundle.

2. Используйте современный API (даже для iOS 8)

Начиная с iOS 8, NSJSONSerialization работает, но лучше использовать JSONSerialization (без префикса NS). Вот исправленный код:

import Foundation

// 1. Получаем путь к файлу
guard let path = Bundle.main.path(forResource: "users", ofType: "json") else {
    print("Файл не найден в bundle")
    return
}

// 2. Читаем данные
guard let jsonData = try? Data(contentsOf: URL(fileURLWithPath: path)) else {
    print("Не удалось загрузить данные из файла")
    return
}

// 3. Парсим JSON
do {
    let json = try JSONSerialization.jsonObject(with: jsonData, options: [])
    
    // 4. Приводим к нужному типу
    if let dictionary = json as? [String: Any],
       let users = dictionary["users"] as? [[String: Any]] {
        for user in users {
            if let id = user["id"] as? Int,
               let name = user["name"] as? String,
               let email = user["email"] as? String {
                print("ID: \(id), Name: \(name), Email: \(email)")
            }
        }
    }
} catch {
    print("Ошибка парсинга JSON: \(error.localizedDescription)")
}

3. Альтернативный способ: чтение из основного Bundle

Если файл лежит в корне проекта, можно использовать Bundle.main.url(forResource:withExtension:):

guard let url = Bundle.main.url(forResource: "users", withExtension: "json") else {
    print("Файл не найден")
    return
}

do {
    let data = try Data(contentsOf: url)
    let json = try JSONSerialization.jsonObject(with: data, options: .mutableContainers)
    // Дальше работаем с json
} catch {
    print("Ошибка: \(error)")
}

4. Работа с JSON в современном Swift (Codable)

Хотя для iOS 8 доступен только JSONSerialization, рекомендую изучить протокол Codable (доступен с iOS 11+). Вот как это выглядит для вашей структуры:

struct User: Codable {
    let id: Int
    let name: String
    let email: String
}

struct UsersResponse: Codable {
    let users: [User]
}

// Чтение
guard let url = Bundle.main.url(forResource: "users", withExtension: "json") else { return }
do {
    let data = try Data(contentsOf: url)
    let response = try JSONDecoder().decode(UsersResponse.self, from: data)
    print(response.users)
} catch {
    print("Ошибка декодирования: \(error)")
}

5. Типичные ошибки и их решение

• Файл не найден: проверьте Target Membership и регистр букв в имени файла
• Ошибка парсинга: убедитесь, что JSON валидный (можно проверить на jsonlint.com)
• nil после приведения типов: используйте безопасное приведение через as? и проверяйте структуру JSON
• Проблемы с кодировкой: если файл в UTF-8, Data читает корректно, но для других кодировок используйте String(contentsOf:encoding:)

Надеюсь, это поможет! Начните с первого варианта, а затем переходите к Codable для более сложных проектов.

import Foundation

// 1. Читаем как строку
guard let path = Bundle.main.path(forResource: "users", ofType: "json"),
      let fileContent = try? String(contentsOfFile: path, encoding: .utf8) else {
    print("Не удалось прочитать файл")
    return
}

// 2. Преобразуем строку в Data
guard let jsonData = fileContent.data(using: .utf8) else {
    print("Ошибка кодирования строки")
    return
}

// 3. Парсим JSON
do {
    let json = try JSONSerialization.jsonObject(with: jsonData, options: [])
    // Обработка...
} catch {
    print("Ошибка: \(error)")
}

func loadUsers(completion: (Result<[User], Error>) -> Void) {
    guard let url = Bundle.main.url(forResource: "users", withExtension: "json") else {
        completion(.failure(NSError(domain: "FileNotFound", code: 404)))
        return
    }
    do {
        let data = try Data(contentsOf: url)
        let users = try JSONDecoder().decode([User].self, from: data)
        completion(.success(users))
    } catch {
        completion(.failure(error))
    }
}