1. 店铺级定位SDK
及刻开放平台
  • 快速开始:API服务
  • 快速开始:MCP服务
  • 网关公共响应码对照
  • 城市ID对照表
  • API能力对接
    • 场景查询
      • 场景查询(ID)
      • 场景查询(区域围栏)
      • 场景查询(名称关键词)
    • 泛客流
      • 区域热力(最近10天)
      • 区域热力(历史数据)
      • 门店客流趋势
      • 门店到访客群画像分布
      • 区域人群分类统计
      • 区域人群画像分布
    • 场景识别
      • 及刻场景识别API
    • WiFi
      • WiFi 位置
      • WiFi 位置(区域检索)
      • WiFi 原始点位
      • WiFi 历史位置
      • WiFi 关联信号
    • 基站
      • 基站位置
      • 基站位置(区域检索)
      • 基站原始点位
      • 基站信号报点
      • 基站关联信号
    • IP地址
      • IP 位置
      • IP 原始点位
      • IP 关联信号
  • 店铺级定位SDK
    • 概述
    • 开发指南
    • Android Studio 配置
    • SDK 功能介绍
      • 初始化SDK
      • 释放SDK
      • 检查SDK是否在工作
      • 获取SDK版本
      • 开始场景识别
      • 停止场景识别
      • 主动触发一次AOI识别
      • 切换SDK城市
      • 上传日志
      • 部分常量介绍
  • 数据模型
    • 场景基础信息
  1. 店铺级定位SDK

Android Studio 配置

1. 下载SDK开发包#

及刻定位SDK
版本:4.11
发布日期:2024-05-14
文件名:geek-sdk-android-lib-open-release.arr
文件大小:500 Kb
文件MD5:202cb962ac59075b964b07152d234b70
点击下载

2. 拷贝SDK至工程#

打开解压后的文件夹,找到.aar文件,然后拷贝.aar文件到工程的app/libs目录下(如果没有libs文件夹自行创建),如图:
image.png

3.设置扁平目录仓库#

打开app的build.gradle文件,在android模块中指定扁平目录仓库地址,代码如下:

4.添加依赖关系#

打开app的build.gradle文件,在dependencies模块中添加依赖关系
注意
最新版本的Android Studio中compile被替换为implementation,具体的写法与您的Android Studio版本有关。
image.png

5.添加混淆规则#

请避免混淆及刻定位SDK,在混淆规则文件中添加规则如下:

6.申请权限#

及刻定位SDK的AAR包已内置所有必要的权限声明
但在应用程序中,动态申请权限需要在初始化SDK之前由开发者提前声明
权限名称APP动态申请权限说明
android.permission.ACCESS_COARSE_LOCATION是若缺失定位权限,SDK不能正常工作,无法识别场景信息
android.permission.ACCESS_FINE_LOCATION是
android.permission.BLUETOOTH否
android.permission.BLUETOOTH_ADMIN否
android.permission.INTERNET否
android.permission.ACCESS_WIFI_STATE否
android.permission.CHANGE_WIFI_STATE否
android.permission.ACCESS_NETWORK_STATE否
APP长期后台运行、或者APP进程在前后台切换的瞬间,经常遇到SDK无法访问基站和WiFi信息,导致场景识别延后,通常可以添加下述2个权限实现ForegroundService后台保活,以此解决问题
该权限非及刻SDK必须,SDK包内部并没有携带这些权限,需要APP自行添加到AndroidManifest.xml中
权限名称APP动态申请权限说明
android.permission.ACCESS_BACKGROUND_LOCATION是
android.permission.FOREGROUND_SERVICE否
修改于 2025-09-05 02:28:16
上一页
开发指南
下一页
初始化SDK
Built with