Notes on SDK Utils package dependencies

更新时间:
复制 MD 格式

This solution applies to the following Alibaba Cloud mobile products:

1. What is the Utils SDK?

Utils is a common dependency package for the SDKs of Alibaba Cloud Multiexperience Development Platform (EMAS) products. It provides basic features and common functional modules. Product SDKs call the Utils SDK interfaces. You do not need to call these interfaces directly during integration.

Android Utils SDK:

  • For manual integration, download the SDK from the Multiexperience Development Platform EMAS console. The dependency package is named alicloud-android-utils-x.x.x.jar.

  • For remote repository integration, you do not need to explicitly configure the repository coordinates.

  com.aliyun.ams
  alicloud-android-utils
  x.x.x

iOS Utils SDK:

  • For manual integration, download the SDK from the Multiexperience Development Platform EMAS console. The dependency package is named AlicloudUtils.framework.

  • For remote repository integration, you do not need to configure it explicitly. After the product SDK is pulled, the corresponding AlicloudUtils folder is located in the Pods/ folder.

2. Utils SDK integration notes

2.1 Integrating only the Mobile Cloud SDK

  • If you integrate all Alibaba Cloud mobile SDKs using a remote repository, Android Maven or iOS CocoaPods automatically pulls the required packages and no conflicts will occur.

  • If you manually integrate all Alibaba Cloud mobile SDKs, download them from the Multiexperience Development Platform EMAS console by checking the required boxes. The backend automatically packages the SDKs and no conflicts will occur.

  • If you integrate Alibaba Cloud mobile SDKs using a mix of remote repository integration and manual integration, delete the Utils SDK from the manually integrated SDK and keep the Utils SDK that was pulled from the remote repository. This mixed integration method is not recommended. We recommend that you use remote repository integration for all SDKs.

2.2 Integrating multiple Alibaba SDKs

If a Utils SDK conflict occurs after you integrate multiple Alibaba SDKs, check whether any SDKs other than the EMAS SDKs contain a Utils SDK. For more information about package naming, see the preceding sections. Delete the Utils SDK package that is not from an EMAS SDK.

For example, the Umeng Push Android SDK integrates the HTTPDNS SDK, which includes a Utils SDK. If a conflict occurs, delete the alicloud-android-utils-1.0.3.jar file.