IM UIKit 提供统一路由IMKitRouter，实现界面的跳转和模块之间的解耦。

IM UIKit 内置界面跳转

IM UIKit 内置的任意界面都可以通过路由地址跳转到其他指定界面。

如何使用路由进行跳转

调用 Navigator 方法进行界面跳转。

方法原型如下：

dart  //带参数的界面跳转
  Navigator.pushNamed(context, path, arguments: {'paramKey': param});
  //不带参数的界面跳转
  Navigator.pushNamed(context, path);

内部路由地址概览

dartimport 'package:common_ui/router/imkit_router_factory.dart';

跳转至用户信息界面

• 示例代码

dart// 封装好的接口
goToContactDetail(context, accId);
// 使用路由跳转
Navigator.pushNamed(context, RouterConstants.PATH_USER_INFO_PAGE, arguments: {'accId': accId});

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_USER_INFO_PAGE	String	用户信息界面的跳转地址
  accId	String	查看用户资料的用户ID
  context	BuildContext	组件上下文

跳转至聊天界面

• 示例代码

dart// 封装好的接口，跳转单聊
goToP2pChat(context, userId);
// 封装好的接口，跳转群聊
goToTeamChat(context, teamId);
// 使用路由跳转
Navigator.pushNamed(context, RouterConstants.PATH_CHAT_PAGE, arguments: {'sessionId': sessionId, 'sessionType': sessionType});

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_CHAT_PAGE	String	聊天界面的跳转地址
  sessionId	String	用户的 ID/群组的 ID，必传
  sessionType	String	会话类型，必传： NIMSessionType.p2p：单聊会话 NIMSessionType.team：群聊会话 ，
  context	BuildContext	组件上下文
  customPopActions	PopMenuAction?	自定义消息弹框事件，非必传
  onTapAvatar	Function(String? userID, {bool isSelf})?	头像点击事件，非必传
  chatUIConfig	ChatUIConfig?	聊天页面定制化配置，非必传
  messageBuilder	ChatKitMessageBuilder?	聊天自定义消息构建，非必传

跳转至群聊搜索界面

• 示例代码

dartNavigator.pushNamed(context, RouterConstants.PATH_CHAT_SEARCH_PAGE, arguments: {'teamId': teamId});

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_CHAT_SEARCH_PAGE	String	群聊搜索界面的跳转地址
  teamId	String	群组的 ID
  context	BuildContext	组件上下文

跳转至群聊设置界面

• 示例代码

dartNavigator.pushNamed(context, RouterConstants.PATH_TEAM_SETTING_PAGE, arguments: {'teamId': teamId});

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_TEAM_SETTING_PAGE	String	群聊搜索界面的跳转地址
  teamId	String	群组的 ID
  context	BuildContext	组件上下文

跳转至新增界面

IM UIKit 提供的路由能力，支持根据您的业务需求新增界面，并支持从其他界面跳转至新增界面。在通过路由实现跳转前，需调用registerRouter方法注册该新增界面的路由地址。 如果需要传递参数，需要使用getArgumentFormMap方法获取对应类型的参数。

方法原型如下：

dartIMKitRouter.instance.registerRouter(String name, WidgetBuilder builder, {Map<String, Object>? arguments})

• 示例代码

dart// 注册群聊设置页面路由
IMKitRouter.instance.registerRouter(
        RouterConstants.PATH_TEAM_SETTING_PAGE,
        (context) => TeamSettingPage(
            UIKitRouter.getArgumentFormMap<String>(context, 'teamId')!));