Este artigo detalha o processo de criação de uma aplicação Android simples, mas funcional, focada no envio de mensagens SMS. A funcionalidade principal envolve a coleta de um número de telefone e o conteúdo da mensagem através de uma interface de usuário e, em seguida, o envio programático dessa mensagem.

Estrutura do Projeto

Um projeto Android típico é composto por vários arquivos essenciais. Para este aplicativo, abordaremos os principais:

• SmsSenderActivity.java: A lógica principal da aplicação.
• layout_envio_sms.xml: O arquivo de layout da interface do usuário.
• strings.xml: Recursos de strings para textos exibidos na UI.
• AndroidManifest.xml: O manifesto da aplicação, onde são declaradas permissões e componentes.

Lógica da Aplicação (SmsSenderActivity.java)

A classe SmsSenderActivity é responsável por gerenciar a interface do usuário e a interação com o sistema Android para enviar SMS. Ela recupera o número de telefone e o conteúdo da mensagem dos campos de texto e utiliza a API SmsManager para realizar o envio.

package com.exemplo.enviosmsapp;

import android.app.Activity;
import android.os.Bundle;
import android.telephony.SmsManager;
import android.view.View;
import android.widget.EditText;
import android.widget.Toast;
import java.util.ArrayList;

public class SmsSenderActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.layout_envio_sms); // Define o layout para esta atividade
    }

    /**
     * Método chamado quando o botão de envio é clicado.
     * Recupera o número do destinatário e o texto da mensagem,
     * e os envia via SmsManager.
     * @param view A View que acionou este método (o botão).
     */
    public void despacharMensagem(View view) {
        // Obtém referências aos campos de entrada da interface
        EditText campoNumero = findViewById(R.id.input_numero_tel);
        EditText campoConteudo = findViewById(R.id.input_texto_sms);

        // Extrai o texto dos campos
        String numeroDestinatario = campoNumero.getText().toString();
        String textoMensagem = campoConteudo.getText().toString();

        // Validação básica para garantir que ambos os campos foram preenchidos
        if (numeroDestinatario.isEmpty() || textoMensagem.isEmpty()) {
            Toast.makeText(this, "Por favor, preencha o número e o conteúdo da mensagem.", Toast.LENGTH_LONG).show();
            return;
        }

        // Obtém uma instância do gerenciador de SMS padrão do sistema
        SmsManager gerenciadorSms = SmsManager.getDefault();

        /*
         * O método divideMessage() é crucial para mensagens longas.
         * Ele divide o texto em várias partes, se exceder o limite de caracteres de um SMS padrão (tipicamente 160 caracteres GSM ou 70 Unicode).
         * Isso garante que a mensagem inteira seja entregue, mesmo que dividida em várias mensagens físicas.
         */
        ArrayList<String> partesMensagem = gerenciadorSms.divideMessage(textoMensagem);

        try {
            // Itera sobre todas as partes da mensagem e as envia individualmente
            for (String parteAtual : partesMensagem) {
                /*
                 * sendTextMessage(destinationAddress, scAddress, text, sentIntent, deliveryIntent)
                 * - destinationAddress: O número de telefone do destinatário.
                 * - scAddress: O endereço do Centro de Serviço SMS (SMSC). Geralmente pode ser 'null' para usar o padrão da operadora.
                 * - text: O conteúdo da parte da mensagem a ser enviada.
                 * - sentIntent: Uma PendingIntent a ser transmitida quando a mensagem é enviada (ou falha). Pode ser 'null'.
                 * - deliveryIntent: Uma PendingIntent a ser transmitida quando a mensagem é entregue ao destinatário. Pode ser 'null'.
                 */
                gerenciadorSms.sendTextMessage(numeroDestinatario, null, parteAtual, null, null);
            }
            Toast.makeText(this, "Mensagem SMS enviada com sucesso!", Toast.LENGTH_SHORT).show();
        } catch (Exception e) {
            // Captura e exibe qualquer erro que possa ocorrer durante o processo de envio
            Toast.makeText(this, "Falha ao enviar mensagem: " + e.getMessage(), Toast.LENGTH_LONG).show();
            e.printStackTrace();
        }
    }
}

Interface do Usuário (layout_envio_sms.xml)

O arquivo de layout define a aparência da tela de envio de SMS. Ele inclui dois campos de texto (EditText) para o número do telefone e o conteúdo da mensagem, e um botão (Button) para acionar o envio.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingLeft="16dp"
    android:paddingTop="16dp"
    android:paddingRight="16dp"
    android:paddingBottom="16dp"
    tools:context="com.exemplo.enviosmsapp.SmsSenderActivity">

    <EditText
        android:id="@+id/input_numero_tel"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/hint_numero_telefone"
        android:inputType="phone"
        android:maxLines="1"
        android:paddingBottom="8dp"/>

    <EditText
        android:id="@+id/input_texto_sms"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/hint_conteudo_sms"
        android:gravity="top"
        android:lines="5"
        android:maxLines="5"
        android:paddingTop="8dp"
        android:paddingBottom="8dp"/>

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:onClick="despacharMensagem"
        android:text="@string/rotulo_botao_enviar"
        android:layout_marginTop="16dp"/>

</LinearLayout>

Recursos de String (strings.xml)

Este arquivo contém todos os textos que serão exibidos na interface do usuário, facilitando a internacionalização e a manutenção do código.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="nome_aplicacao">Enviador SMS</string>
    <string name="hint_numero_telefone">Digite o número de telefone</string>
    <string name="hint_conteudo_sms">Insira o conteúdo da mensagem</string>
    <string name="rotulo_botao_enviar">Enviar SMS</string>
</resources>

Maniefsto da Aplicação (AndroidManifest.xml)

O AndroidManifest.xml é o arquivo de configuração central de um aplicativo Android. Nele, declaramos os componentes da aplicação (atividades, serviços, etc.) e as permissões necessárias para o seu funcionamento. Para enviar SMS, a permissão SEND_SMS é essencial.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.exemplo.enviosmsapp"
    android:versionCode="1"
    android:versionName="1.0">

    <uses-sdk
        android:minSdkVersion="14"
        android:targetSdkVersion="31" />

    <!-- Declara a permissão necessária para enviar mensagens SMS -->
    <uses-permission android:name="android.permission.SEND_SMS" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/nome_aplicacao"
        android:theme="@android:style/Theme.Material.Light.DarkActionBar">
        <activity
            android:name=".SmsSenderActivity"
            android:label="@string/nome_aplicacao"
            android:exported="true"> <!-- 'exported' é necessário para apps que visam API 31+ -->
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>