Android URL Scheme唤醒之门

Posted 2023-03-18

参考技术A 1、scheme的作用

android的scheme 是一种页面内跳转协议。通过scheme 可以进行页面跳转，可以是app之间的跳转，
也可以是网页和app之间的跳转。

2、scheme的定义

协议://协议地址/端口/路径/参数
scheme://nade/startapp?data= "123456"

协议：scheme(可以自定义)
协议地址：（可以自定义）
端口：（可以自定义）
路径：
参数：

3、scheme的使用

1、app内使用：
/**
* scheme跳转
* @param s
*/
private void schemeJump(String s)
if (!checkScheme(s))
showToast("页面不存在");

Intent schemeIntent = new Intent(Intent.ACTION_VIEW);
schemeIntent.setData(Uri.parse(s));
startActivity(schemeIntent);


2、网页内使用

// h5调用
<a href="scheme://nade/startapp?data=123456">app目标页面</a>

3、app解析处理

Intent intent = getIntent();
if (intent.getData() != null)
Uri uri = intent.getData();
//获取uri链接
LogUtils.d("nade",uri.toString());
//获取协议
LogUtils.d("nade",uri.getScheme());
//获取协议链接
LogUtils.d("nade",uri.getHost());
//获取端口
LogUtils.d("nade",String.valueOf(uri.getPort()));
//获取路径
LogUtils.d("nade",uri.getPath());
//获取参数
LogUtils.d("nade",uri.getQueryParameter("data"));
//获取参数集合
for (String data : uri.getQueryParameters("data"))
LogUtils.d("nade",data);



/**
* 检测scheme链接是否可用
* @param s
* @return
*/
public boolean checkScheme(String s)
PackageManager manager = getPackageManager();
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(Uri.parse(s));
List<ResolveInfo> uris = manager.queryIntentActivities(intent, PackageManager.GET_RESOLVED_FILTER);
return uris != null && uris.size() > 0;

Android外部唤醒APP跳转指定页面

Android外部链接唤醒APP

• 原理
• • 两个新创的activity
  • H5OpenAppActivity源码
  • EventJumpActivity

原理

通过scheme协议来唤醒APP。

一.定义一个能响应外部链接的Activity——H5OpenAppActivity，H5OpenAppActivity获取外部唤醒该activity的URL，通过intent传给其他activity。再由H5OpenAppActivity来判断app是否在后台运行，还是从未打开，还是刚刚下载。

1.刚刚下载时，由H5OpenAppActivity跳SplashActivity，GuideActivity，主activity。SplashActivity和GuideActivity主要是把外部唤醒H5OpenAppActivity的URL传递给主activity。

2.已经下载过，打开过但是后台程序已经杀死，由H5OpenAppActivity跳SplashActivity，主activity。

3.该app在后台挂着，由H5OpenAppActivity跳SplashActivity，主activity。

注意：如果没有跳转的页面，默认打开应用之前的栈顶activity，如果有则打开主页面，因为我们的跳转逻辑写在主页面里

二.为什么都要跳主activity呢?
因为我们除了新起一个H5OpenAppActivity用来相应外部唤起的链接，还定义了一个EventJumpActivity用来跳转到想唤起的页面。

两个新创的activity

1.android:scheme=“openapp"是唤起的协议
2. android:host=”$applicationId"是app名字

 <!--start H5唤起APP-->
        <activity
            android:name="com.hundsun.main.openapp.H5OpenAppActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
            android:noHistory="true">
            <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />

                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />

                <data
                    android:host="$applicationId"
                    android:scheme="openapp" />
            </intent-filter>
        </activity>
        <activity
            android:name="com.hundsun.main.openapp.EventJumpActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>
        <!--end H5唤起APP-->

H5OpenAppActivity源码

public class H5OpenAppActivity extends FragmentActivity 

    @Override
    protected void onResume() 
        Intent i_getvalue = getIntent();
        if (i_getvalue != null) 
            String action = i_getvalue.getAction();
            if (Intent.ACTION_VIEW.equals(action)) 
                Uri uri = i_getvalue.getData();
                if ((i_getvalue.getFlags() & Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY) != 0) 
                    startMainActivity(null);
                 else 
                    if (uri != null) 
                        startMainActivity(uri);
                    
                
            
        
        super.onResume();
        finish();
    

    private void startMainActivity(Uri uri) 
        boolean hasOpenMainPage = false;
        try 
            if (HsActivityManager.getInstance().getTopActivity() != null && HybridCore.getInstance().getPageManager().getPageCount() > 0) 
                hasOpenMainPage = true;
            
         catch (NullPointerException e) 
        

        //resume逻辑会将LightSchemeActivity也算进来，当程序没启动时从三方跳转会打开本Activity因此要排除
        if (hasOpenMainPage && isTopActivity(H5OpenAppActivity.this)) 
            resumeCurrentActivity(uri);
         else 
            Intent startintent = getPackageManager().getLaunchIntentForPackage(getPackageName());
            startintent.putExtra(IntentKeys.H5_OPEN_APP_URI, uri);
            startintent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP
                    | Intent.FLAG_ACTIVITY_CLEAR_TASK
                    | Intent.FLAG_ACTIVITY_NEW_TASK);
            startActivity(startintent);
        
    

    private void resumeCurrentActivity(Uri uri) 
        ActivityManager manager = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
        List<ActivityManager.RunningTaskInfo> task_info = manager.getRunningTasks(30);
        String className = "";
        String packgeName = getPackageName();
        for (int i = 0; i < task_info.size(); i++) 
            if (packgeName.equals(task_info.get(i).topActivity.getPackageName())) 
                //关键
                manager.moveTaskToFront(task_info.get(i).id, ActivityManager.MOVE_TASK_WITH_HOME);
                className = task_info.get(i).topActivity.getClassName();
            
        
        String url = "";
        try 
            if (uri != null) 
                url = uri.getQuery();
            
         catch (Exception e) 
        
        if (!TextUtils.isEmpty(url)) 
            //如果没有跳转的页面，默认打开应用之前的栈顶activity，如果有则打开主页面，因为我们的跳转逻辑写在主页面里
            TemplateItem page = HybridCore.getInstance().getTemplateParser().getTemplate("main");
            className = page.getClassname();
        
        if (!TextUtils.isEmpty(className)) 
            Intent intentgo = getIntent();
            Bundle bundle = intentgo.getExtras();
            if (bundle == null) 
                bundle = new Bundle();
            
            bundle.putBoolean("isFromNotifacation", true);
            intentgo.putExtras(bundle);
            intentgo.setAction(Intent.ACTION_MAIN);
            intentgo.addCategory(Intent.CATEGORY_LAUNCHER);
            try 
                intentgo.setComponent(new ComponentName(this, Class.forName(className)));
             catch (ClassNotFoundException e) 
                e.printStackTrace();
            
            intentgo.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT
                    | Intent.FLAG_ACTIVITY_NEW_TASK
                    | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
            Intent targetInaget = new Intent(this, EventJumpActivity.class);
            targetInaget.putExtra(IntentKeys.H5_OPEN_APP_URI,uri);
            Intent[] intents = new Intent[]intentgo, targetInaget;
            startActivities(intents);
        
    

    public static boolean isTopActivity(Context mContext) 
        //此为google推荐的方法，并且不需要添加新的权限。
        String packageName = mContext.getPackageName();
        ActivityManager am = (ActivityManager) mContext.getApplicationContext().getSystemService(Context.ACTIVITY_SERVICE);
        List<ActivityManager.RunningAppProcessInfo> list = am.getRunningAppProcesses();
        if (list.size() == 0) 
            return false;
        
        for (ActivityManager.RunningAppProcessInfo process : list) 
            if (process.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND &&
                    process.processName.equals(packageName)) 
                return true;
            
        
        return false;
    

EventJumpActivity

public class EventJumpActivity extends FragmentActivity 

    private void processIntent(Intent data) 
        Uri uri = data.getParcelableExtra(IntentKeys.H5_OPEN_APP_URI);
        try 
            if ("openapp".equals(uri.getScheme())) 
                /**
                *此处填入自己的跳转逻辑
                */
            
         catch (Exception e) 

        
    

    @Override
    protected void onResume() 
        super.onResume();
        processIntent(getIntent());
        finish();