安卓打电话软件源码拆解：告别调不通，附完整示例

复制来的拨号代码跑不通？别急着骂娘，大概率是你没搞懂底层权限与Intent的匹配逻辑。今天直接上源码，给你一份能跑通的完整示例，省得你再对着文档猜半天。

入口定位：从点击到系统拨号面板

在安卓开发里，打电话这个动作看起来简单，其实就是个“中转站”。你以为你在写业务逻辑，其实你是在跟系统服务打交道。很多新手栽就栽在以为直接写个 startActivity 就能把电话打出去，结果发现要么没反应，要么弹个框让你确认。这背后其实是 Android 框架的设计哲学：安全隔离。

咱们先看入口。在 Activity 里，通常是一个按钮触发。但真正的“入口”不在你的 App 代码里，而在系统的 TelephonyManager 或者 Intent 分发机制里。

当你调用 ACTION_DIAL 时，系统会把你扔进系统自带的拨号应用界面，用户手动点拨号键才真正拨出。当你调用 ACTION_CALL 时，系统会直接发起呼叫，但前提是：你必须有 CALL_PHONE 权限，且用户已经在设置里授权给你这个权限（Android 6.0+）。

这里有个巨大的坑：隐式 Intent 的冲突。如果你只写 setAction(Intent.ACTION_CALL)，不指定 setData，或者数据格式不对，系统可能不知道你要打给谁，直接 Crash 或者静默失败。

核心片段：权限检查与Intent构建

下面这段代码是实际项目中经过多次踩坑后的稳定版本。注意，这不是教科书式的“理想代码”，而是能真正跑在 Android 10+ 设备上的“实战代码”。

// 文件: CallHelper.java
package com.example.caller.util;import android.Manifest;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Build;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;public class CallHelper {/*** 发起呼叫* @param context 上下文* @param phoneNumber 手机号* @return 是否成功发起*/public static boolean makeCall(Context context, String phoneNumber) {// 1. 前置校验：号码是否为空或格式明显错误if (phoneNumber == null || phoneNumber.trim().isEmpty()) {return false;}// 2. 权限检查：这是最容易出错的地方// Android 6.0 (API 23) 之后，运行时权限必须动态申请if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {int permissionCheck = ContextCompat.checkSelfPermission(context, Manifest.permission.CALL_PHONE);// 如果权限未授予，这里不能直接申请，因为申请权限需要 Activity 上下文// 实际业务中，这里应该返回 false，让上层 UI 去处理权限申请弹窗if (permissionCheck != PackageManager.PERMISSION_GRANTED) {return false; }}try {// 3. 构建 Intent// 关键点：必须使用 tel: 协议，这是 Android 开发者文档明确规定的 URI 格式Intent intent = new Intent(Intent.ACTION_CALL, Uri.parse("tel:" + phoneNumber));// 4. 防止被其他应用劫持（可选但推荐）// 指定组件，强制使用系统拨号应用，避免被恶意应用拦截// 注意：不同 ROM 的拨号应用包名不同，这里用隐式 Intent 更通用// 如果必须指定，需判断默认拨号应用context.startActivity(intent);return true;} catch (Exception e) {// 捕获异常：通常是因为用户拒绝了权限，或者没有默认拨号应用e.printStackTrace();return false;}}
}

逐行拆解重点：

Build.VERSION.SDK_INT >= Build.VERSION_CODES.M：这是 Android 6.0 的分水岭。老版本代码如果不加这个判断，在低版本手机上可能直接崩溃，因为 checkSelfPermission 是 6.0 才有的 API。
ContextCompat.checkSelfPermission：千万别直接用 context.checkSelfPermission，要用 Support 库的封装，兼容性好。
Uri.parse("tel:" + phoneNumber)：这里有个大坑。如果号码里有空格、短横线或者 + 号，直接拼接可能导致 URI 解析错误。最佳实践是：在传参前清洗号码，只保留数字和 +。
catch (Exception e)：很多人觉得这里没意义，但在安卓实际运行中，ActivityNotFoundException 或 SecurityException 是常客。静默吞掉异常并返回 false，让 UI 层提示用户“请检查设置”，比 Crash 强一万倍。

设计思想：为什么 Android 这么“啰嗦”？

很多从 iOS 转过来，或者刚入行的人，会吐槽 Android 打电话太麻烦，要申请权限、要判断版本、要处理 URI。其实这背后是沙盒机制与用户控制权的博弈。

在 iOS 上，你直接调 tel:// 就行，系统弹窗问用户要不要打。Android 的逻辑是：你的 App 没有权利直接控制用户的电话硬件。CALL_PHONE 权限是一个危险权限（Dangerous Permission），因为它可以被滥用（比如恶意扣费、骚扰）。

所以，源码设计思想的核心是：防御性编程。

权限最小化：不要一上来就申请所有权限。只在用户点击“拨打”按钮的那一刻，才检查并申请 CALL_PHONE。
状态同步：权限申请是异步的。你申请完权限，用户点了“允许”，这时候你需要回调里再执行 startActivity。上面的 CallHelper 是同步逻辑，实际项目中，你应该配合 ActivityResultLauncher 使用。
URI 规范化：Android 的 Uri 类对特殊字符非常敏感。tel: 协议只接受标准电话号码格式。

参考 Android 官方开发者文档 中关于 TelephonyManager 和 Intent 的章节，你会发现官方推荐的方式并不是直接 startActivity，而是结合 QueryIntent 检查系统是否支持该 Action。但在 99% 的国内主流 ROM 上，系统都支持 ACTION_CALL，所以直接构建 Intent 是性价比最高的方案。

手写简化版：从零搭建拨号流程

为了让你彻底理解，我们写一个极简的 Activity，模拟从 UI 到系统拨号的完整链路。

// 文件: MainActivity.java
package com.example.caller;import android.Manifest;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Bundle;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;public class MainActivity extends AppCompatActivity {private static final int REQUEST_CODE_CALL = 1001;private EditText etPhone;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);etPhone = findViewById(R.id.et_phone);Button btnCall = findViewById(R.id.btn_call);btnCall.setOnClickListener(v -> {String number = etPhone.getText().toString().trim();if (number.isEmpty()) {Toast.makeText(this, "请输入号码", Toast.LENGTH_SHORT).show();return;}// 检查权限if (ContextCompat.checkSelfPermission(this, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {// 没权限，申请ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.CALL_PHONE}, REQUEST_CODE_CALL);} else {// 有权限，直接拨startCall(number);}});}@Overridepublic void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {super.onRequestPermissionsResult(requestCode, permissions, grantResults);if (requestCode == REQUEST_CODE_CALL) {if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {// 用户同意了，这时候才能拨startCall(etPhone.getText().toString().trim());} else {Toast.makeText(this, "权限被拒绝，无法拨打", Toast.LENGTH_SHORT).show();}}}private void startCall(String number) {try {Intent intent = new Intent(Intent.ACTION_CALL, Uri.parse("tel:" + number));startActivity(intent);} catch (Exception e) {Toast.makeText(this, "拨打失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();}}
}

这段代码的精髓在于 onRequestPermissionsResult 的回调。

很多新手代码跑不通，就是因为他们在 OnClickListener 里直接写了申请权限的逻辑，然后紧接着写 startActivity。但权限申请是异步的！用户点“允许”可能需要 1 秒，你这 1 秒内 startActivity 就执行了，此时权限还没拿到，直接抛 SecurityException。

正确姿势：申请权限 -> 等待回调 -> 回调里确认授权 -> 再执行拨打逻辑。

应用场景：不止是打电话

理解了这套源码逻辑，你会发现它不只适用于“打电话”这个功能。

短信发送：把 ACTION_CALL 换成 ACTION_SENDTO，URI 换成 smsto:，逻辑几乎一样。
微信/钉钉分享：同样是隐式 Intent，同样需要检查目标应用是否存在。
支付调起：支付宝、微信支付的 SDK 底层也是类似的 Intent 或 Deep Link 机制。

进阶避坑指南：

号码清洗：Uri.parse 对 + 号敏感。如果用户输入 +8613800000000，直接拼接没问题。但如果输入 +86 138 0000 0000，URI 解析会出错。务必在 startCall 前，用正则表达式去掉所有非数字和非 + 的字符。
默认拨号应用：如果用户把默认拨号应用改成了第三方（如 Hi 呼叫），你的 ACTION_CALL 依然有效，因为系统会路由到默认应用。但如果你用了 setPackage 强制指定 com.android.dialer，在小米或华为手机上可能会报 ActivityNotFoundException。不要指定包名，除非你非常确定。
Android 12+ 限制：新版 Android 对隐式 Intent 启动后台 Activity 有限制。但打电话是前台交互，只要你的 Activity 在前台，就没问题。