RELEASE NOTES
------------------------------------------------------------------------------
Shield for iOS - Version 5.0.2 - 2022-11-18


Highlights:
------------------------------------------------------------------------------
- This is a bugfix release.


Supported platforms:
------------------------------------------------------------------------------
- Shield is supported on iOS 11.0 and up to iOS/iPadOS 16.

- Shielder requires Java 11 (LTS) or Java 17 (LTS) run-time environment.

  Shielder requires a macOS system in order to sign applications and/or
  use bitcode obfuscation.

- Shield supports Xcode 12 and higher. Promon recommends using
  Xcode version 13.4.1 for now.


Deprecations:
------------------------------------------------------------------------------
- Apple has announced with Xcode 14 that bitcode will be deprecated.
  Shielder's obfuscation depends on bitcode, and is expected to still be able
  to process bitcode-enabled apps with Xcode 14.


Changes:
------------------------------------------------------------------------------

* SHIOS-2134: Binding issue with iOS apps running on macOS

  When running a Shielded macOS/Catalyst/iOS app on macOS, there are cases
  where the applications were crashing on startup. Specifically, this was 
  an issue when either using the configuration option binaryBindingVersion
  set to 2 or when the app was compiled with the minumum iOS version set
  to 13.4 or above or the minimum macOS version was set to 12.0.
  This change fixes these issues.

* SHIOS-1287: Build libshield for arm64 simulator

  Added arm64 architecture to Shield framework.

* SHIOS-2144: Updates expected TestFlight leaf certificate hash

  In less than 90 days the TestFlight leaf certificate will expire.
  Apple is now using a new TestFlight leaf certificate that Shield now trusts
  instead. The workaround is no longer needed to stop Shield from detecting
  TestFlight releases as repackaged.


Known limitations
------------------------------------------------------------------------------
* Blocking of external screens, such as AirPlay does currently not work for
  apps using UISceneDelegate in iOS 13 and above.

* "--shield-all-extensions" does not add Shield to AppClips.

* "--shield-all-extensions"

  This option will add Shield to all extensions from the default Plugins
  folder. 

* The combination of "--obfuscate-app" and "--xcode" only works when
  exporting an ipa from Xcode, not for running the app directly from
  xcode.


Tested devices:
------------------------------------------------------------------------------
Apple iPad 5th generation iOS 13.1.2
Apple iPad 6th Gen iOS 13.2.3
Apple iPad 6th Gen iOS 13.6
Apple iPad 7th Gen, OS iPadOS 14.6
Apple iPad Air 11.4.1
Apple iPad mini 2 iOS 12.2
Apple iPad Pro iOS 11.4.1
Apple iPhone 5s iOS 12
Apple iPhone 5s iOS 12.5.5
Apple iPhone 6 iOS 12.4
Apple iPhone 6 iOS 12.4.2
Apple iPhone 6 iOS 13.5.1.
Apple iPhone 6s 14.7
Apple iPhone 6s+ 11.4
Apple iPhone 7 iOS 13.0
Apple iPad 7th Gen iOS 14.8
Apple iPad 8th Gen iOS 15.2
Apple iPhone 8 iOS 12.4.1
Apple iPhone 8 iOS 13.3.1
Apple iPhone SE iOS 16.2 Beta 3
Apple iPhone X iOS 12.3
Apple iPhone XS iOS 12.3.1
Apple iPhone XR iOS 13.1.3
Apple iPhone XR iOS 14.2
Apple iPhone XS Max iOS 12.0
Apple iPhone 11 iOS 13.7
Apple iPhone 12 iOS 15.7.1
Apple iPhone 13 iOS 16.1.1
Apple iPod Touch iOS 11.2.5 ELECTRA
Apple iPod Touch iOS 11.3.1 ELECTRA
Apple iPod Touch iOS 11.4.1 Electra
Apple iPod Touch iOS 11.4.1 unc0ver
Apple iPod Touch iOS 12.0.1 uncover
Apple iPod Touch iOS 12.2
Apple iPod Touch 2020 iOS 14.0.1
Apple iPad 8th Gen iOS 15.2


Tools:
------------------------------------------------------------------------------
Xcode 13.4.1
Xcode 14.0.1
Xcode 14.1