Health Connect

به توسعه دهندگان اجازه می دهد تا سوابق سلامت و تناسب اندام کاربر را بخوانند یا بنویسند.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
16 اکتبر 2024 - - - 1.1.0-آلفا10

درخواست دسترسی به انواع داده

برای کمک به تقویت حریم خصوصی و امنیت کاربر، توسعه‌دهندگانی که با Health Connect ادغام می‌شوند باید دسترسی خواندن و/یا نوشتن را برای انواع داده‌هایی که برنامه‌هایشان استفاده می‌کنند اعلام کنند . توسعه‌دهندگان باید موارد استفاده معتبری را برای انواع داده‌هایی که استفاده می‌کنند بر اساس هدف برنامه لحاظ کنند. برای اطلاعات بیشتر، از ارائه اطلاعات برای فرم اعلامیه برنامه‌های سلامت و Health Connect توسط مجوزهای Android دیدن کنید.

اعلام وابستگی ها

برای افزودن وابستگی به سلامت، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha09"
}

کاتلین 

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha09")
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

Health Connect Testing نسخه 1.0

نسخه 1.0.0-alpha01

4 سپتامبر 2024

androidx.health.connect:connect-testing:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 حاوی این تعهدات است.

ویژگی های جدید

کتابخانه Health Connect Testing ایجاد تست های خودکار را ساده می کند. می‌توانید از این کتابخانه برای تأیید رفتار برنامه‌تان و تأیید درستی پاسخ صحیح آن به موارد غیرمعمول، که آزمایش دستی آن‌ها سخت است، استفاده کنید.

می‌توانید از کتابخانه برای ایجاد تست‌های واحد محلی استفاده کنید، که معمولاً رفتار کلاس‌هایی را در برنامه شما که با کلاینت Health Connect تعامل دارند تأیید می‌کنند.

نقطه ورود به کتابخانه کلاس FakeHealthConnectClient است که در آزمایشات جایگزین HealthConnectClient استفاده می کنید. دارای ویژگی های زیر است:

  • نمایشی از رکوردها در حافظه، بنابراین می توانید آنها را درج، حذف، حذف و بخوانید
  • تولید نشانه های تغییر و ردیابی تغییر
  • صفحه بندی برای سوابق و تغییرات
  • پاسخ‌های انباشتگی با خرد پشتیبانی می‌شوند
  • به هر تابعی اجازه می دهد تا استثناها را ایجاد کند
  • یک FakePermissionController که می تواند برای شبیه سازی بررسی های مجوز استفاده شود

تغییرات API

  • FakeHealthConnectClient e8469 را اضافه کنید
  • اضافه کردن موارد خرد برای FakeHealthConnectClient e8469

نسخه 1.1

نسخه 1.1.0-alpha10

16 اکتبر 2024

androidx.health.connect:connect-client:1.1.0-alpha10 ، androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha10 و androidx.health.connect:connect-client-proto:1.1.0-alpha10 منتشر شد. نسخه 1.1.0-alpha10 حاوی این تعهدات است.

ویژگی های جدید

  • اضافه شدن انواع تجمع SkinTemperature . ( Ibe123 )
  • ثابت FEATURE_PLANNED_EXERCISE اضافه شد ( Ie02a3 )
  • مجوزهای History Reads اضافه شد. ( I5cf41 )
  • API برنامه های آموزشی اضافه شد ( If5be1 )
  • SkinTemperatureRecord API اضافه شد. ( I5605d )

رفع امنیتی

  • با توجه به این تغییر ، androidx در برابر protobuf 4.28.2 به منظور آدرس دهی CVE-2024-7254 کامپایل می شود. وابستگی خود را به androidx.health:connect:connect-client-proto و androidx.health:connect:connect-client-external-protobuf به آخرین نسخه 1.1.0-alpha10 ارتقا دهید تا خطر آسیب پذیری را برطرف کنید.

نسخه 1.1.0-alpha09

18 سپتامبر 2024

androidx.health.connect:connect-client:1.1.0-alpha09 ، androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha09 و androidx.health.connect:connect-client-proto:1.1.0-alpha09 منتشر شد. نسخه 1.1.0-alpha09 حاوی این commit ها است.

ویژگی های جدید

  • مجوز خواندن پس‌زمینه را اضافه کنید، که توسط در دسترس بودن ویژگی محافظت می‌شود. ( I01036 , I44db9 )

نسخه 1.1.0-alpha08

4 سپتامبر 2024

androidx.health.connect:connect-client:1.1.0-alpha08 ، androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha08 و androidx.health.connect:connect-client-proto:1.1.0-alpha08 منتشر شد. نسخه 1.1.0-alpha08 حاوی این commit ها است.

تغییرات API

  • مقدار پیش فرض را برای متغیر ویژگی ها در HealthConnectClient تنظیم کنید. ( I788dc )
  • برای بررسی در دسترس بودن ویژگی، یک API اضافه کنید. ( Iedd43 )

رفع اشکال

  • زمانی که HealthConnectManager در U+ 5802f خالی است، SDK_UNAVAILABLE در HealthConnectClient.getSdkStatus() برگردانید
  • اضافه کردن toString لغو به RecordClasses aa5dc
  • طرح دستی دسترسی به APIهای پلتفرم جدید حذف شد زیرا این به طور خودکار از طریق مدلسازی API هنگام استفاده از R8 با AGP 7.3 یا جدیدتر (مثلا R8 نسخه 3.3) و برای همه ساخت‌ها هنگام استفاده از AGP 8.1 یا بالاتر (به عنوان مثال D8 نسخه 8.1) اتفاق می‌افتد. به مشتریانی که از AGP استفاده نمی‌کنند، توصیه می‌شود به نسخه 8.1 یا بالاتر D8 به‌روزرسانی کنند. برای جزئیات بیشتر به این مقاله مراجعه کنید. ( If6b4c , b/345472586 )

نسخه 1.1.0-alpha07

10 ژانویه 2024

androidx.health.connect:connect-client:1.1.0-alpha07 منتشر شد. نسخه 1.1.0-alpha07 حاوی این commit ها است.

تغییرات API

  • هنگامی که #getSdkStatus از یک بافت کاربر نمایه فراخوانی می شود، SDK_UNAVAILABLE برگردانید. ( I91df3 )
  • SleepStageRecord حذف کنید. ( /If6ada )

رفع اشکال

  • RemoteException به جای IllegalStateException در خرابی های اتصال پرتاب کنید. ( ID2233 )

نسخه 1.1.0-alpha06

18 اکتبر 2023

androidx.health.connect:connect-client:1.1.0-alpha06 منتشر شد. نسخه 1.1.0-alpha06 حاوی این commit ها است.

تغییرات API

  • تعاریف recordingMethod را عمومی می کند. ( I401fb )

رفع اشکال

  • اسناد را به مسیر تمرین اضافه کنید و مشخص کنید که مکان باید قبل از زمان پایان جلسه باشد. ( 0e51e6 )

نسخه 1.1.0-alpha05

4 اکتبر 2023

androidx.health.connect:connect-client:1.1.0-alpha05 منتشر شد. نسخه 1.1.0-alpha05 حاوی این commit ها است.

تغییرات API

  • قصد اضافه شده است که به صفحه مدیریت داده سلامت اتصال هدایت می شود. ( IBF591 )
  • روش‌های منسوخ شده در AggregationResult حذف شدند. ( Idbda9 )
  • API راحتی برای ایجاد ReadRecordsRequest و همچنین حذف و خواندن رکوردها با نوع رکورد اصلاح شده اضافه شده است. ( If58a5 )

رفع اشکال

  • اشکالی در Android 14 رفع شد که در آن فیلدهای تغذیه پوچ به عنوان Double.MIN_VALUE برگردانده می شدند. ( 1aa1d1 )
  • رفع اشکالی در Android 14 که در آن انباشتگی بر اساس دوره ماهانه/سالانه به دلیل داشتن زمان شروع/پایان یکسان در سطل‌ها، یک استثنا در پاسخ ایجاد می‌کرد. ( 281313 )

نسخه 1.1.0-alpha04

6 سپتامبر 2023

androidx.health.connect:connect-client:1.1.0-alpha04 منتشر شد. نسخه 1.1.0-alpha04 حاوی این commit ها است.

تغییرات API

رفع اشکال

نسخه 1.1.0-alpha03

26 جولای 2023

androidx.health.connect:connect-client:1.1.0-alpha03 منتشر شد. نسخه 1.1.0-alpha03 حاوی این commit ها است.

ویژگی های جدید

  • API برای خواندن و نوشتن مسیرهای تمرین:
    • ExerciseRouteResult به ExerciseSessionRecord اضافه شد
    • ExerciseRouteRequestContract اضافه شد

تغییرات API

  • ExerciseRouteResult و زیر کلاس‌های آن اضافه شد: Data ، NoData و ConsentRequiredStates .
  • ExerciseRoute به عنوان یک کلاس مستقل اضافه شده است که داده های مکان را برای مسیر نگه می دارد. ( I22eed )
  • PERMISSION_WRITE_EXERCISE_ROUTE اضافه شد. ( I92fc4 )
  • ExerciseRouteRequestContract اضافه شد، HealthPermissionsRequestContract اضافه شد. ( Ief0e5 )

رفع اشکال

  • ساخت ثابت انرژی بر حسب کیلوژول ( Ie8791 )

نسخه 1.1.0-alpha02

21 ژوئن 2023

androidx.health.connect:connect-client:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 حاوی این commit ها است.

رفع اشکال

  • رفع نشت HealthDataSdkService ( Ia3ba5 )
  • هنگام درخواست مجوز در Android U. ( I6415a ) همیشه به HealthConnect Client مناسب هدایت شوید.

نسخه 1.1.0-alpha01

7 ژوئن 2023

androidx.health.connect:connect-client:1.1.0-alpha01 منتشر شد. این نسخه در یک شعبه داخلی توسعه یافته است.

ویژگی های جدید

  • پشتیبانی از نسخه فریمورک Android 14 Health Connect. این SDK یک پیش نیاز برای Android 14 است. برنامه ها بدون آن نمی توانند با Health Connect در Android 14 ادغام شوند.
  • اضافه شدن روش ضبط برای ضبط متادیتا.

تغییرات API

  • تغییرات Session API:
    • مراحل مختلف خواب را به SleepSessionRecord اضافه کرد و SleepStageRecord حذف کرد.
    • ExerciseLap و ExerciseSegment به ExerciseSessionRecord اضافه شد.
  • محدودیت‌های نرخ دوره‌ای و روزانه (از جمله محدودیت حافظه)، برای عملیات خواندن، تغییرات، درج و حذف.
  • اعتبار برای تمام فیلدهای NutritionRecord اضافه شده است.
  • اعتبار برای HeartRateVariabilityRmssdRecord اضافه شده است.
  • دو API منسوخ حذف شد: HealthConnectClient#isProviderAvailable و HealthConnectClient#isApiSupported .

رفع اشکال

  • برابری واحدهای ثابت برای همه انواع واحدها، برابری دیگر به نوع مورد استفاده برای مقداردهی اولیه واحد بستگی ندارد. به عنوان مثال Mass.grams(1000) اکنون برابر است با Mass.kilograms(1).

نسخه 1.0

نسخه 1.0.0-alpha11

22 فوریه 2023

androidx.health.connect:connect-client:1.0.0-alpha11 منتشر شد. نسخه 1.0.0-alpha11 حاوی این commit ها است.

تغییرات API

  • افزودن یک هدف برای استفاده برای باز کردن Health Connect. ( IC8055 )
  • حذف برخی از انواع ورزش به جای انواع حذف شده از EXERCISE_TYPE_STRENGTH_TRAINING ، EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING یا EXERCISE_TYPE_CALISTHENICS استفاده کنید. ( I7291c )
  • افزودن API جدید sdkStatus() که ترکیبی از دو API منسوخ شده isSdkSupported() و isProviderAvailable() است. ( Iac89d )
  • تغییر APIهایی که providerPackageName می پذیرند تا یک رشته را بجای یک لیست بپذیرند. ( I67e0f )

نسخه 1.0.0-alpha10

25 ژانویه 2023

androidx.health.connect:connect-client:1.0.0-alpha10 منتشر شد. نسخه 1.0.0-alpha10 حاوی این commit ها است.

تغییرات API

  • ExerciseEventRecord ، ExerciseLapRecord ، ExerciseRepititionRecord و SwimmingStrokesRecord دیگر به عنوان RecordTypes پشتیبانی نمی شوند. آنها دیگر نمی توانند از HealthConnect نوشته یا خوانده شوند. هر گونه ارجاع به این انواع داده را از ادغام HealthConnect حذف کنید. ( If7ca2 )
  • تغییرات در APIهای مجوز برای پذیرش مجوزها در قالب رشته ای جدید. این تغییر همچنین مستلزم تغییر اعلان مجوز به فرمت استاندارد مجوزهای اندروید است. ( Ib0a2f )

نسخه 1.0.0-alpha09

11 ژانویه 2023

androidx.health.connect:connect-client:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 حاوی این commit ها است.

ویژگی های جدید

  • 2 نوع داده سلامت زن جدید برای Health Connect اضافه شد: IntermenstrualBleedingRecord و MenstruationPeriodRecord . MenstruationFlow.ENUMs سبک، متوسط، سنگین و ناشناخته هستند.

تغییرات API

  • IntermenstrualBleedingRecord ( Idc470 ) اضافه شد
  • اضافه شدن نوع رکورد MenstruationPeriodRecord ( Iea545 )

نسخه 1.0.0-alpha08

7 دسامبر 2022

androidx.health.connect:connect-client:1.0.0-alpha08 منتشر شد. نسخه 1.0.0-alpha08 حاوی این commit ها است.

تغییرات API

  • BodyWaterMass ، HeartRateVariabilityRmssdRecord را به عنوان انواع ضبط پشتیبانی شده جدید اضافه می کند. ( Ifd58f )
  • HipCircumferenceRecord ، WaistCircumferenceRecord به عنوان RecordTypes پشتیبانی شده حذف می کند. ( I62fb9 )
  • MenstruationFlowRecord.flow از stringdef به intdefs تغییر کرد. ( I0369f )
  • برای عملکرد بهتر، فیلدهای رکورد مانند enum را با Strings به Integers تغییر داد. ( I3b295 )
  • فیلدهای ExerciseSession ، ExerciseRepetitions ، SleepStage enum مانند را از رشته به عدد صحیح تغییر داد. ( ID32a9 )
  • تغییر نام ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL . ( I5d7bd )
  • "غیر معمول" را به فهرست CervicalMucus اضافه می کند. برای جزئیات بیشتر، "Clear" را به "Eggwhite" تغییر دهید. تغییر CervicalMucus#appearance از StringDefs به IntDefs. ( I3ac51 )
  • StringDef از DeviceTypes enum اکنون به IntDefs تحت Device منتقل شده است. ( I3abf3 )
  • HealthConnectClient.isApiSupported() را اضافه می کند، که در نسخه های SDK بدون پیاده سازی سازگار، false را برمی گرداند. تغییر نام HealthConnectClient.isAvailable->isProviderAvailable . ( I3674e )

رفع اشکال

  • مقادیر HeartRate beatsPerMinute کمتر از 1 را مجاز نکنید ( I6052f )
  • افزودن حاشیه نویسی @JvmDefaultWithCompatibility ( I8f206 )

نسخه 1.0.0-alpha07

24 اکتبر 2022

androidx.health.connect:connect-client:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 حاوی این commit ها است.

تغییرات API

  • آرگومان های ضبط بدون مقادیر پیش فرض قبل از آرگومان هایی با مقادیر پیش فرض قرار می گیرند. برای ثبات، آرگومان های Instant و ZoneOffset همیشه در همان ابتدا قرار می گیرند. ( ID618c )
  • تغییر نام HealthConnectClient.getOrCreate#packageNames به providerPackageNames . ( ID81e4 )

رفع اشکال

  • تأیید ارزش فیلد رکورد را اضافه می کند. مقادیر بسیار اشتباه زمانی که مقدار ارائه شده خارج از محدوده معقول باشد، IllegalArgumentExceptions ایجاد می کند. ( Ie171d )
  • در صورت لزوم، زمان شروع رکورد را قبل از زمان پایان تأیید می کند. ( I02460 )

نسخه 1.0.0-alpha06

5 اکتبر 2022

androidx.health.connect:connect-client:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 حاوی این commit ها است.

رفع اشکال

  • چرخه عمر اتصال سرویس را بهبود می بخشد. ( If2bd5 )
  • رفع اشکال خرابی NPE زمانی که استثنا در اتصال سرویس مطرح شود. ( I13546 )

نسخه 1.0.0-alpha05

21 سپتامبر 2022

androidx.health.connect:connect-client:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 حاوی این commit ها است.

تغییرات API

  • Metadata.uid -> Metadata.id تغییر نام داد و از اصطلاحات recordId به طور مداوم در سراسر APIهای CRUD مرتبط استفاده کرد. ( I3d1d2 )
  • ساخت PermissionController.createRequestPermissionActivityContract یک متد ثابت به جای روش نمونه. به PermissionController.createRequestPermissionResultContract تغییر نام داد. ( Icd2fe )
  • اضافه شدن نوع واحد BloodGlucose برای BloodGlucoseRecord ( I97678 )
  • تغییر نام MenstruationRecord -> MenstruationFlowRecord . ( I3b88e )

رفع اشکال

  • اصلاح رفتار ناخواسته عدم انتشار آمار پیش زمینه از فرآیند مشتری. ( Ifb44c )

نسخه 1.0.0-alpha04

24 آگوست 2022 androidx.health.connect:connect-client:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 حاوی این commit ها است.

مهاجرت به androidx.health.connect

از تاریخ 1.0.0-alpha04، androidx.health:health-connect-client به androidx.health.connect:connect-client منتقل شد. برای نسخه‌های قبلی Health Connect، لطفاً از صفحه androidx.health دیدن کنید.

برای مهاجرت، به سادگی وارد کردن وابستگی خود را از androidx.health:health-connect-client:1.0.0-alpha03 به androidx.health.connect:connect-client:1.0.0-alpha04 تغییر دهید.

ویژگی های جدید

  • شامل گزارش‌های اشکال‌زدایی اختیاری داخلی برای تماس‌های API ( پیوند )

تغییرات API

  • تغییر نام متادیتا clientId به clientRecordId , clientVersion به clientRecordVersion . ( لینک )
  • Uid Metadata را برای خوانندگان دوستانه‌تر کرد و دیگر قابل تهی نیست. ( لینک )
  • پوند اضافه شده به واحد توده ( لینک )
  • تغییر نام DeletionChange.deleteUid به uid ( پیوند )
  • تغییر نام مجوز -> HealthPermission. این از ابهام در مجوزهای Android Framework جلوگیری می کند. ( لینک )

رفع اشکال

  • رفع مشکلات رگرسیون مربوط به واحد کالری نادرست با انرژی ( لینک )
  • رفع مشکل رگرسیون با تجمع برای چند نوع رکورد ( لینک )