Sophix: Notes on the Utils dependency package

更新时间:
复制 MD 格式

  • The Utils software development kit (SDK) is a common dependency package for Alibaba Cloud mobile product SDKs. It provides implementations of basic features and common functional modules. Other Alibaba Cloud SDK products call the Utils SDK interfaces—you do not call them directly during integration.

  • Sophix hotpatching requires Utils package version 1.0.3 or later.

  • If you use multiple Alibaba Cloud SDK products, you may introduce duplicate dependencies on the Utils SDK. Keep only the highest-version Utils package and delete the packages from other products. For remote dependencies, use exclude(module:'alicloud-android-utils') to remove them.

  • If the final Utils package you keep is version 1.1.1 or later, note the following. The latest hotpatching version includes Utils package version 1.1.3.

    • For remote dependencies, a ut dependency package may be included. If a conflict occurs, add exclude(module:'alicloud-android-ut') to filter it. However, this also removes the utdid package. Check all Alibaba-related dependencies in your project and ensure that you keep only one utdid package with version 1.1.5.3 or later.

    • For local dependencies, or for remote dependencies after you add exclude(module:'alicloud-android-ut'), you may receive the following error when you enable obfuscation and package the APK:

      Warning:com.alibaba.sdk.android.utils.c$1: can't find superclass or interface com.ut.mini.IUTApplication
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTAnalytics
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTHitBuilders
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTHitBuilders$UTCustomHitBuilder
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTHitBuilders$UTHitBuilder
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTTracker
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTAnalytics
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTHitBuilders$UTCustomHitBuilder
      Warning:com.alibaba.sdk.android.utils.c: can't find referenced class com.ut.mini.UTTracker
      Warning:com.alibaba.sdk.android.utils.c$1: can't find referenced class com.ut.mini.IUTApplication
      Warning:com.alibaba.sdk.android.utils.c$1: can't find referenced class com.ut.mini.core.sign.UTBaseRequestAuthentication
      Warning:com.alibaba.sdk.android.utils.c$1: can't find referenced class com.ut.mini.core.sign.IUTRequestAuthentication
      Warning:com.alibaba.sdk.android.utils.c$1: can't find referenced class com.ut.mini.crashhandler.IUTCrashCaughtListner
      Warning:there were 19 unresolved references to classes or interfaces.
    • Alternatively, you may receive the following error:

      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find superclass or interface com.alibaba.sdk.android.beacon.Beacon$OnUpdateListener
      Warning:com.alibaba.sdk.android.utils.crashdefend.a: can't find referenced class com.alibaba.sdk.android.beacon.Beacon
      Warning:com.alibaba.sdk.android.utils.crashdefend.a: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$Builder
      Warning:com.alibaba.sdk.android.utils.crashdefend.a: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$OnUpdateListener
      Warning:com.alibaba.sdk.android.utils.crashdefend.a: can't find referenced class com.alibaba.sdk.android.beacon.Beacon
      Warning:com.alibaba.sdk.android.utils.crashdefend.a: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$Builder
      Warning:com.alibaba.sdk.android.utils.crashdefend.a: can't find referenced class com.alibaba.sdk.android.beacon.Beacon
      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find referenced class com.alibaba.sdk.android.beacon.Beacon
      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$Config
      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$OnUpdateListener
      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$Config
      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find referenced class com.alibaba.sdk.android.beacon.Beacon
      Warning:com.alibaba.sdk.android.utils.crashdefend.a$b: can't find referenced class com.alibaba.sdk.android.beacon.Beacon$Config
      Warning:there were 21 unresolved references to classes or interfaces.
    • If you receive either of the preceding errors, or a similar error such as Warning:com.alibaba.sdk.android.utils.**, add -dontwarn com.alibaba.sdk.android.utils.** to your obfuscation rules to resolve the issue.

If the preceding steps do not resolve the issue, contact Technical Support.