README

注意：此项目正在开发中（WIP），尚未准备好用于生产环境。我们正在努力实现稳定版本，欢迎贡献、建议和反馈。

👋🏻 简介

欢迎来到 FIT 文件解析库，这是一个基于 PHP 的库，用于解析 FIT 文件。FIT（灵活和可互操作的数据传输）文件常用于健身设备中存储锻炼数据。此库灵感来源于 Garmin SDK，但独立开发，旨在为 PHP 社区提供开源替代方案。
FIT 协议文档可以在这里找到

Garmin 是 Garmin Ltd. 或其子公司的注册商标，此库是一个独立项目，与 Garmin 没有任何关联。

🛠️ 功能

解析 FIT 文件：读取并解析 FIT 文件到 PHP 数据对象。

📚 安装

要使用此库，请使用以下命令安装：

composer require arnaud-deabreu/fit-php-parser

📝 解析 FIT 文件

<?php

use FitParser\Parser;

$parser = new Parser(
    file_get_contents('path/to/fit/file.fit')
);
$parser->parse();

$parser->getRecords(); // FitParser\Records\Record[]

🧙🏻‍♂️ 生成消息和字段类

要生成从 FIT 文件解码二进制字符串所需的必要消息和字段类，您需要使用 make fitparser-gen-profile 命令。
此命令需要 Profile.xlsx 文件，该文件包含在 Garmin SDK 中。
首先，从 Garmin 开发者网站下载 Garmin SDK。下载完成后，在 SDK 中找到 Profile.xlsx 文件，并将其放置在此项目的数据文件夹中。
文件放置正确后，您可以运行 make fitparser-gen-profile 命令，该命令将处理文件并生成解析和解码 FIT 文件数据所需的类。

许可证

此库采用 MIT 许可证。有关更多详细信息，请参阅 LICENSE 文件。

免责声明

此库处于早期开发阶段，不应在生产环境中使用。作者不对使用此库造成的数据丢失或损害负责。

联系方式

如有任何疑问，请通过 GitHub Issues 联系。

arnaud-deabreu / fit-php-parser

维护者

详细信息