SuperMap iMobile for Android开发入门（iMobile 10i + AS 3.6）

超图防坑指南

机缘巧合，报名了超图的 命题开发组竞赛，想着，就像是写个小作业，就能完成，顺便领个小证书啥的（主要是想接触下超图软件，万一美帝真的有后续操作呢）。 不过， 哎？？ 超图这坑太深了吧！他们的视频教程做了好多遍，细究了好多的细节（大概就是 仔细看每帧视频画面吧），也没能Debug Successful。在超图群里问了好几次，最终在 聊大 尚泽兄弟 的协助下完成了HelloMap之SuperMap Version，小兄弟才大二，不过跳坑技能实属高超，佩服佩服。

文章概要

1. AS3.6安装、SuperMap iMobile 10i下载 ，一笔带过；
2. HelloMap工程创建 ，必要步骤记录；
3. HelloMap示例代码 ，贴代码 + 部分讲解；
4. HelloMap完整工程下载 ，提供下载链接（GitHub + CSDN）；

AS3.6安装、SuperMap iMobile 10i下载

AS3.6下载链接： Android Studio 的下载页面下载最新版 或者是 下载AS 3.5.2 的 exe

SuperMap iMobile 10i下载链接： SuperMap iMobile 10i SP1 for Android(2019-12-31)

SuperMap iMobile 10i试用的License文件： SuperMap Online

HelloMap工程创建

1. 创建工程
   常规操作

2. 导入jar包
   这里导入data和mapping这两个包就可以了

3. 导入.so文件
   直接复制了整个文件夹（armeabi-v7a）过来

4. 配置activity.xml
   添加MapView控件

5. 配置activity.java
   初始化环境、打开工作空间、关联地图控件和工作空间、权限适配

6. 配置Manifest.xml
   添加网络权限、读写文件权限等

7. 配置build.gradle
   添加ndk和sourceSets节点，详细实例代码见下节
   划重点：超图官方教程未进行ndk节点设置，这里不设置会报错的，亲测！

8. 数据导入手机
   直接使用USB连接手机后，把示例数据和License文件导入手机根目录就行

HelloMap示例代码

build.gradle：

// buid.gradle的部分关键代码
apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    buildToolsVersion "29.0.3"

    defaultConfig {
        ...
        minSdkVersion 16
        targetSdkVersion 28
        ...

        ndk {
            abiFilters 'armeabi-v7a'
        }

    }

    buildTypes {
            ...
    }

    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }

}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
        ...
    implementation files('libs/com.supermap.data_v1001.jar')
    implementation files('libs/com.supermap.mapping_v1001.jar')
}

activity.xml：

// activity_main的全部代码

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        <com.supermap.mapping.MapView
            android:id="@+id/mapview"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            >
        com.supermap.mapping.MapView>
    RelativeLayout>>

androidx.constraintlayout.widget.ConstraintLayout>

activity.java：

// MainActivity的全部代码
package com.bestyou.myapplication;

import androidx.appcompat.app.AppCompatActivity;
import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.util.Log;
import com.supermap.data.Environment;
import com.supermap.data.Workspace;
import com.supermap.data.WorkspaceConnectionInfo;
import com.supermap.data.WorkspaceType;
import com.supermap.mapping.MapControl;
import com.supermap.mapping.MapView;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        checkPermission();

        //初始化环境
        Environment.setLicensePath("/sdcard/SuperMap/license/");
        Environment.setTemporaryPath("/sdcard/SuperMap/temp/");
        Environment.setWebCacheDirectory("/sdcard/SuperMap/WebCatch");
        Environment.initialization(this);

        setContentView(R.layout.activity_main);

        //打开工作空间
        Workspace workspace = new Workspace();
        WorkspaceConnectionInfo info = new WorkspaceConnectionInfo();
        info.setServer("/sdcard/SuperMap/GeometryInfo/World.smwu");
        info.setType(WorkspaceType.SMWU);
        workspace.open(info);

        //将地图显示控件和工作空间关联
        MapView mapView = findViewById(R.id.mapview);
        MapControl mapcontrol = mapView.getMapControl();
        mapcontrol.getMap().setWorkspace(workspace);

        //打开工作空间中的第1幅地图
        String mapName = workspace.getMaps().get(0);
        mapcontrol.getMap().open(mapName);
        mapcontrol.getMap().refresh();
    }

    //动态权限适配
    public void checkPermission() {
        boolean isGranted = true;
        if (android.os.Build.VERSION.SDK_INT >= 23) {
            if (this.checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                //如果没有写sd卡权限
                isGranted = false;
            }
            if (this.checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                isGranted = false;
            }
            Log.i("cbs","isGranted == "+isGranted);
            if (!isGranted) {
                this.requestPermissions(
                        new String[]{
                                Manifest.permission.READ_PHONE_STATE,
                                Manifest.permission.MOUNT_UNMOUNT_FILESYSTEMS,
                                Manifest.permission.ACCESS_COARSE_LOCATION,
                                Manifest.permission.ACCESS_FINE_LOCATION,
                                Manifest.permission.READ_EXTERNAL_STORAGE,
                                Manifest.permission.WRITE_EXTERNAL_STORAGE},
                        102
                );
            }
        }
    }
    
}

Manifest.xml：

 <-- AndroidManifest的全部代码 -->

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.bestyou.myapplication">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission
        android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"
        tools:ignore="ProtectedPermissions" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        
        <activity android:name=".MainActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:label="@string/app_name">
            
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            intent-filter>
            
        activity>
        
    application>
    
    <supports-screens
        android:anyDensity="true"
        android:largeScreens="true"
        android:normalScreens="true"
        android:resizeable="true">
    supports-screens>
    
manifest>

HelloMap完整工程下载

想直接运行下，看看Demo的可直接下载完整工程：

CSDN链接: 有下载积分的点这里下载完整工程.
希望有CSDN积分的大佬能打赏下积分，谢谢~

Github链接: 用爱发电.
学生党去Github就好了~

手机端导入数据完整示例： CSDN下载链接.
可直接拷贝到手机的根目录，即：手机根目录->SuperMap->其他文件夹（包括示例数据、license、缓存文件夹）