Imported from thinkreed/code-migration-spec (knowledge/platforms/android-harmonyos/AGENTS.md). Install upstream with npx skills add thinkreed/code-migration-spec --skill android-harmonyos. Copyright stays with the author.

Android → HarmonyOS Knowledge

OVERVIEW

Android 平台到 HarmonyOS 平台的映射知识。

PLATFORM MAPPING

UI COMPONENT MAPPING

LIFECYCLE MAPPING

DATA STORAGE MAPPING

NETWORK MAPPING

API TRANSFORM EXAMPLES

# Activity → Ability
- source: android.app.Activity
  target: ohos.aafwk.ability.Ability
  transform:
    - onCreate → onStart
    - onDestroy → onStop
    - setContentView → setUIContent
    - findViewById → findComponentById

# RecyclerView → ListContainer
- source: android.support.v7.widget.RecyclerView
  target: ohos.agp.components.ListContainer
  transform:
    - setAdapter → setItemProvider
    - LinearLayoutManager → DirectionalLayout (vertical)
    - Adapter → BaseItemProvider

CODE EXAMPLES

Activity → Ability

Android (Activity)

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        TextView tv = findViewById(R.id.text_view);
        tv.setText("Hello");
    }
}

HarmonyOS (Ability)

public class MainAbility extends Ability {
    @Override
    protected void onStart(Intent intent) {
        super.onStart(intent);
        setUIContent(ResourceTable.Layout_ability_main);
        Text tv = findComponentById(ResourceTable.Id_text_view);
        tv.setText("Hello");
    }
}

RecyclerView → ListContainer

Android (RecyclerView)

RecyclerView recyclerView = findViewById(R.id.recycler_view);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setAdapter(new MyAdapter(dataList));

// Adapter
public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        holder.textView.setText(dataList.get(position));
    }
}

HarmonyOS (ListContainer)

ListContainer listContainer = findComponentById(ResourceTable.Id_list_container);
listContainer.setItemProvider(new MyItemProvider(dataList));

// ItemProvider
public class MyItemProvider extends BaseItemProvider {
    @Override
    public Component getComponent(int position, Component convertComponent, ComponentContainer container) {
        Text textView = new Text(container.getContext());
        textView.setText(dataList.get(position));
        return textView;
    }
}

NOTES

• HarmonyOS 使用 ArkTS 作为推荐开发语言（类似 TypeScript）
• 部分组件名称相同但 API 不同
• 生命周期差异较大，需特别注意
• 资源引用方式不同（ResourceTable.Id_xxx vs R.id.xxx）