This repository was archived by the owner on May 15, 2024. It is now read-only.
  
  
  - 
                Notifications
    You must be signed in to change notification settings 
- Fork 497
Release Notes
        James Montemagno edited this page Jun 18, 2019 
        ·
        26 revisions
      
    Below you will find detailed release notes for Xamarin.Essentials.
- New experimental file features have been added. See release notes below.
- GH-817 Android Idiom Crash on disposed object
- GH-808 Don't Strip URL fragments from Browser OpenAsync
- GH-800 Emailing with multiple file attachments on Android fails
- GH-788 Emailing on pre-n Android devices with attachments fail
- GH-794 Fix for iOS Launch.OpenAsync crash with spaces in URL
- GH-740 Possible crash on iOS geolocation null reference
- GH-745 Ensure return of full Android device size
- GH-771 Ensure correct return of PlatformRemove in SecureStorage
- GH-776 Cleanup UWP VM for DeviceType.Virtual
- GH-786 Ensure android playback speed is always 1 on Android
- GH-510 Additional Null checks for UWP mainview
- GH-126 Detect Shake API (part of accelerometer)
- GH-196 Browser customization for colors and browser title mode
- GH-676 New IsFromMockProvider flag on Location from Geolocation
- GH-182 Helper libraries for Color/Point/Rect/Size
- GH-714 Use original string for URI with launcher.
- GH-698 Longer delay to handle Android connectivity changes
- GH-704 Better handling of duplicate items on iOS Secure Storage
- GH-694 Ensure VS Hyper-V Emulator is marked at Emulator device
- GH-636 Optimization on Android Preferences
- GH-707 Don't add empty emails to emails on UWP
- GH-130 Built in Android File Provider
- GH-129 Add file to email as attachment
- GH-425 Add file to share API
- GH-649 Connectivity - Fix for duplicate connection profiles showing up
- GH-656 Connectivity - Some Android devices were showing "Local" when in airplane mode.
- GH-621 Permissions - Ensure we only call items on main thread when needed.
- 
DeviceIdiom: now supports Watch on Android
- 
SecureStorage: Several fixes for older devices
- 
UnitConverters: New static helpers that convert units!
There were several breaking changes from earlier preview versions of Xamarin.Essentials. Here is a guide on transitioning:
- 
All Sensors: Throw an InvalidOperationExceptionif already monitoring
- 
AppInfo: OpenSettingsis nowShowSettingsUI
- 
Barometer: Pressureis nowPressureInHectopascals
- Battery: If no battery 1 is returned for charge level
- 
Battery: BatteryChangedEventArgsis nowBatteryInfoChangedEventArgs
- 
Browser: OpenAsyncnow returns a boolean if launched successfully
- 
Browser: BrowserLaunchMode.SystemPreferedis now 0 andExternalis 1
- 
Clipboard: SetTextis nowSetTextAsync
- 
Compass: ApplyLowPassFilteris removed and now a parameter for Start
- 
Connectivity: Profilesis nowConnectionProfiles
- 
Connectivity: WiMAXis removed and now returnsCellularforConnectionProfile
- 
Connectivity: Otheris nowUnknownforConnectionProfileand 0
- 
Data Transfer: Renamed to Share
- 
DeviceInfo.Idioms: DeviceInfo.Idiomsno longer exists and is nowDeviceIdiom
- 
DeviceInfo.Platforms: DeviceInfo.Platformsno longer exist and is nowDevicePlatform
- 
DeviceDisplay: ScreenMetricsproperty is nowMainDisplayInfo
- 
DeviceDisplay: ScreenMetricsstruct is nowDisplayInfo
- 
DeviceDisplay: ScreenRotationis nowDisplayRotation
- 
DeviceDisplay: ScreenOrientationis nowDisplayRotationand returns Unknown if not known
- 
DeviceDisplay: ScreenMetricsChangedis nowMainDisplayInfoChanged
- 
DeviceDisplay: ScreenMetricsChangedEventArgsis nowDisplayInfoChangedEventArgs
- 
Geocoding: MapKeyfor UWP is nowPlatform.MapServiceTokenand only available in the UWP platform
- 
Geolocation: GeolocationAccuracynow has a Default, which is Medium
- 
Location: CalculateDistanceparameters have changed, take in (LatitudeStart, LongitudeStart, LatitudeEnd, LongitudeEnd) for consistency.
- 
Maps: Mapsis nowMap
- 
Maps: MapDirectionModeis nowNavigationMode
- 
Maps: MapsLaunchOptionsis nowMapLaunchOptions
- Platform: No longer exists in the .net standard library
- 
Power: EnergySaveris now located inBattery
- 
ScreenLock: Has moved into DeviceDisplayand is a single propertyKeepScreenOn
- 
SensorSpeed: Normalis nowDefaultfor all sensors
- 
TextToSpeech: SpeakSettingsis nowSpeechOptions
- GH-448 Fix exception in SecureStorage when backup is turned on for newer devices
- GH-466 Add ToString overrides to help with debugging #531
- GH-464 SecureStorage Optimizations on iOS for disposing objects #499
- GH-523iOS Fix exception when info.Pist doesn't have key in AppInfo #525
- GH-383 Support for multiple recipients when sending SMS #484
- GH-492 Fix Android P string parsing of version number, now returns 9.0 #491
- GH-260 Integrated sourcelink #260
- GH-476 Geolocation updates to ensure geolocation is turned on #488
- GH-464 Ensure Invariant Culture is used in text to speech api #483
- GH-373 Ensure permission prompts happen on UI thread. #487
- GH-474 All structs now implement IEquality #474
- 
GH-453 Fix OnScreenMetricsChanged from being called multiple times if no changes. #455 
- 
GH-440 iOS Maps only show if set to None for Navigation #444 
- 
Additional optimiations of all structs to implement IEquatable 
- GH-348 Add Barometer Sensor API #459
- Maps - Ability to do navigation on UWP/Android #444
- Geolocation now has Course and Speed on Location #445
- GH-287 NEW Maps API to open maps to location or placemark #404
- GH-250 NEW Launcher API - used to open generic URIs. #405
- GH-366 iOS - now returns specific hw.machine for DeviceInfo.Model #395
- GH-365 All - Use Generic EventHandler for all event delegates #375
- GH-367 All - Change naming of SensorSpeed.UI and BatterySource.AC #374
- GH-337 Android - Added "Low Pass Filter" option on android compass by @Mrnikbobjeff #354
- GH-388 Android - Provide better exception when Activity is null on Android due to Init not being called. #396
- GH-343 iOS - Take VerticalAccuracy into consideration when returning iOS Altitude by @dotmorten #344
- GH-380 Android - Fix issue with "valid handle" in secure storage#386
- Fixed typo in ScreenMetricsChanagedEventArgs -> ScreenMetricsChangedEventArgs
- GH-434 Android: Use unique identifier for each feature for preferences. Resets VersionTracking if used.
- GH-419 UWP: Fixes for sensor stops. All: Sync sensor speeds.
- GH-294 Geolocation - Added Altitude #329
- GH-291 Rename Platform to MainThread #325
- GH-231 New API - Open Settings on AppInfo #328
- GH-310 Android - Update nuget packags to 27.0.2.1 #311
- GH-304 Secure Storage - Add Remove and RemoveAll #330
- GH-306 Fix for Calculate Distance between two locations #307
- GH-316 Secure Storage - Return null for key with no value #320
- GH-317 Secure Storage - Fix to broaden accessible query from .6 to .7 #321
- GH-309 Android - Optimizations to tracking activity state #323
This release adds new APIs and additional enhancements.
- GH-245 Add Orientation Sensor API.
- GH-254 Build against Android 8.1 and depend on Support 27.X libraries. #279
- GH-192 Add DateTime to Preferences API. #232
- GH-281 Add API to allow setting heading calibration on iOS. Also default to false for compass. #282
- GH-240 Add IsMainThread API to Platform and refactor code. #277
- GH-229 - Email subject and body missing on iOS. #230
- GH-236 Fix Dependencies on Android (Update SDK Extras) could cause install issues on older projects.
- GH-246 - Fix up and document secure storage tests on iOS. #278 #247
- GH-272 - Fix null exception on iOS Simulator for querying last known location. #276
- Initial Release. See documentation at: https://docs.microsoft.com/en-us/xamarin/essentials/